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.

Libraries

componentes/circular_loader
componentes/componentes
componentes/tooltip_span
componentes/vvs_button
componentes/vvs_icon_button
extensions/double_extension
extensions/extensions
extensions/list_extensions
extensions/string_extensions
services/dialog/dialog_service
services/dialog/dialogs
services/dialog/flutter_dialog_service
services/http/external/adapters/dio_client_adapter
services/http/external/adapters/vvs_sistemas_dio_adapter
services/http/external/errors/http_exception
services/http/external/mappers/dio_response_mapper
services/http/external/responses/responses
services/http/external/responses/tipo_mensagem
services/http/external/responses/vvs_response
services/http/external/responses/vvs_response_mensagem
services/http/external/responses/vvs_void_response
services/http/https
services/http/infra/http_client
services/http/infra/http_response
services/internet/connection_type
services/internet/internet
services/internet/internet_connectivity_plus_service
services/internet/internet_service
services/local_storage/local_storage_service
services/local_storage/local_storages
services/local_storage/shared_preferences_local_storage_service
services/services
shared/base_hook_view
shared/base_view
shared/base_viewmodel
shared/shared
utils/copy_to_clipboard
utils/exclude_glow_scroll_behavior
utils/formatters/format_currency
utils/formatters/format_date
utils/formatters/format_decimal
utils/formatters/format_percentage
utils/formatters/format_telefone
utils/formatters/formatters
utils/generate_guid
utils/get_clipboard_data
utils/helpers/cep_helper
utils/helpers/cnpj_helper
utils/helpers/cpf_cnpj_helper
utils/helpers/cpf_helper
utils/helpers/helpers
utils/helpers/telefone_helper
utils/hide_keyboard
utils/http_overrides
utils/input_formatters/adiciona_separador
utils/input_formatters/centavos_input_formatter
utils/input_formatters/cep_input_formatter
utils/input_formatters/cnpj_input_formatter
utils/input_formatters/compound_formatter
utils/input_formatters/cpf_input_formatter
utils/input_formatters/cpf_ou_cpnj_formatter
utils/input_formatters/data_formatter
utils/input_formatters/input_formatters
utils/input_formatters/placa_veiculo_input_formatter
utils/input_formatters/real_input_formatter
utils/input_formatters/telefone_input_formatter
utils/keyboard_is_opened
utils/resulter
utils/string_utils
utils/utils
utils/versao_do_app
vvs_core
vvs_core_http