/vvs_core

Package usado nos projetos em Flutter da VVS Sistemas 💙

Primary LanguageDartMIT LicenseMIT

VVS Core

pub package

Pacote utilizado nos projetos Flutter da empresa VVS Sistemas.

Obs: É recomendado que utilize este package somente nos projetos da empresa VVS Sistemas.

Instalação

1. Dependência

Adicione isto ao arquivo pubspec.yaml do seu pacote:

dependencies:
    vvs_core: ^version

2. Instalação

Você pode instalar pacotes a partir da linha de comando:

$ flutter pub get
..

3. Importação

Agora em seu código Dart, você pode usar:

import 'package:vvs_core/vvs_core.dart';

Dependências utilizadas:

As dependências que este projeto utiliza são:

  1. shared_preferences: Armazenar dados localmente no local storage do dispositivo.

  2. dio: Executar requisições HTTP.

  3. uuid: Gerar GUID's.

  4. equatable: Igualdade entre classes.

  5. animate_do: Animações facilitadas.

  6. google_fonts: Fontes do Google.

  7. intl: Internacionalização.

  8. flutter_hooks: Gerenciar ciclos de vida de widget's.

  9. package_info_plus: Obter informações nativas do aplicativo.

  10. connectivity_plus: Verificar conexão com a internet.

Utilidades do pacote

Todas as features existentes no pacote são:

Utils:

  1. copyToClipboard: Utilitário para copiar algum texto.

  2. ExcludeGlowScrollBehavior: Widget para remover efeito de glow na rolagem das listas.

  3. generateGuid: Gerar GUIDS.

  4. getClipboardData: Obter texto copiado do clipboard.

  5. hideKeyboard: Utilitário para fechar o teclado.

  6. keyboardIsOpened: Utilitário para verificar se o teclado está aberto.

  7. Resulter: Classe para separar o caso de sucesso e erro em uma única classe.

  8. formatCurrency: Utilitário para formatar números para o formato -> "R$ 9.999,99".

  9. formatDate: Utilitário para formatar datas.

  10. formatDecimal: Utilitário para formatar números para o formato -> "1.000.000,00".

  11. formatPercentage: Utilitário para formatar números para o formato -> "10%".

  12. formatTelefone: Utilitário para formatar strings para o formato -> "(xx) xxxxx-xxxx".

  13. CepHelper: Helper para validar, formatar e remover carácteres do CEP.

  14. CnpjHelper: Helper para validar, formatar, gerar e remover carácteres do CNPJ.

  15. CpfCnpjHelper: Helper para validar, formatar e remover carácteres do CPF ou CNPJ.

  16. TelefoneHelper: Helper para formatar e remover carácteres do Telefone.

  17. CentavosInputFormatter: Input formatter para formatar moedas com centavos em Text Field's.

  18. CepInputFormatter: Input formatter para formatar cep's em Text Field's.

  19. CnpjInputFormatter: Input formatter para formatar cnpj's em Text Field's.

  20. CpfInputFormatter: Input formatter para formatar cpf's em Text Field's.

  21. CpfOuCnpjFormatter: Input formatter para formatar cpf's ou cnpj's em Text Field's.

  22. DataInputFormatter: Input formatter para formatar datas em Text Field's.

  23. PlacaVeiculoInputFormatter: Input formatter para formatar placas de veículos em Text Field's.

  24. RealInputFormatter: Input formatter para formatar moedas em Text Field's.

  25. TelefoneInputFormatter: Input formatter para formatar telefones em Text Field's.

Shared

  1. BaseHookView: Classe para criar views (páginas) com viewmodels utilizando o pacote "flutter_hooks".

  2. BaseView: Classe para criar views com viewmodels.

  3. BaseViewModel: Classe para criar viewmodels.

Services

  1. FlutterDialogService: Serviço utilizado para exibir dialog's.

    • Este serviço não utiliza nenhum pacote externo para exibição de dialog's, para utilizar siga os passos que estão no arquivo "flutter_dialog_service.dart".

  2. VvsSistemasDioAdapter: Adaptador do HTTP Client para requisições para api's com o padrão de response da VVS Sistemas.

  3. InternetConnectivityPlusService: Serviço utilizado para verificar conexão com internet.

    • Este serviço utiliza o pacote "connectivity_plus".

  4. SharedPreferencesLocalStorageService: Serviço utilizado para ler, salvar e deletar dados do local storage do dispositivo.

Extensões

  1. double_extension:

    • arredondar: Arrendondar números em casas decimais.
    • casoForZero: Retorna um valor X caso o valor atual for zero.
    • getValueOrDefault: Retornar um valor X caso o valor atual for nulo.

  2. list_extensions:

    • sumBy: Somar alguma propriedade da lista.
    • separarComVirgulas: Separar valores por virgulas
      • Exemplo: ['VVS Sistemas', 'Google'] = "VVS Sistemas, Google".

  3. string_extensions:

    • whereNullOrEmpty: Retorna um valor caso for nulo ou vazio.
    • toDateTime: Retorna um DateTime a partir de uma String.
      • O formato da string deve ser "dia/mês/ano".
    • capitalize: Capitalização da String
      • Exemplo: "texto exemplo PARA CAPITALIZAÇÃO" = "Texto exemplo para capitalização"
    • removeWhitespace: Remove todos os espaços em branco da String.
    • contemNumero: Verifica se a string contém números.
    • contemCaracterEspecial: Verifica se a string contém carácteres especiais.
    • isInstagramUser: Verifica se a string começa com "@".

Componentes

  1. CircularLoader
  2. TooltipSpan: Text.rich com Tooltip.
  3. VvsButton: Botão padrão dos app's.
  4. VvsIconButton: Botão padrão com ícone dos app's.