Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev2.0.2

flutter_config

Um plugin que expõe variáveis de ambiente ao seu código Dart no Flutter, bem como ao seu código nativo no iOS e Android. Traga um pouco do amor 12-factor para seus aplicativos Flutter

AndroidiOS
Downloads em 30 dias
2,7 mil
Curtidas
211
Pontos Pub
140

Instalar pacote

flutter pub add flutter_config

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

flutter_config é um plugin Flutter que permite acesso contínuo a variáveis de ambiente tanto no código Dart quanto no código nativo para Android e iOS. Ele traz os princípios de aplicativos 12-factor para o Flutter, permitindo que desenvolvedores gerenciem configurações externamente, melhorando segurança e flexibilidade em diferentes ambientes como desenvolvimento, homologação e produção. O pacote lê as configurações de arquivos específicos da plataforma (por exemplo, info.plist no iOS, build.gradle no Android) e as expõe como constantes no Dart. Isso ajuda a evitar codificação rígida de valores sensíveis e simplifica os fluxos de implantação.

Casos de uso

  • Gerenciando pontos de extremidade da API por ambiente
  • Armazenar chaves de API com segurança
  • Alternando entre configurações de dev/estágio/prod
  • Personalizando o comportamento do aplicativo com base no ambiente
  • Habilitando flags de recurso por configuração
  • Compartilhando configuração com código nativo

Principais recursos

  • Suporta plataformas Android e iOS
  • Lê a configuração dos arquivos nativos do projeto
  • Expõe variáveis para o Dart e código nativo
  • Segue a metodologia de aplicação 12-factor
  • Integração fácil por meio do pub add
  • Sem sobrecarga em tempo de execução

Indicado para

  • Desenvolvedores usando múltiplos ambientes
  • Equipes que precisam de gerenciamento seguro de configuração
  • Aplicativos que exigem acesso a código nativo para configuração
  • Projetos que seguem os princípios do 12-factor
  • Pipelines de CI/CD com configurações específicas do ambiente
  • Aplicativos com alternadores de funcionalidades dinâmicas

Considerações

  • A configuração deve ser definida antes do aplicativo iniciar
  • Dados sensíveis não devem ser confirmados no controle de versão
  • Requer configuração manual em projetos nativos
  • Não adequado para alterações de configuração em tempo de execução
  • Limitado a valores estáticos no momento da compilação
  • Necessita de documentação adequada para onboarding da equipe

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Config Variables for your Flutter apps

Plugin that exposes environment variables to your Dart code in Flutter as well as to your native code in iOS and Android.

Inspired by react-native-config

Basic Usage

Create a new file .env in the root of your Flutter app:

API_URL=https://myapi.com
FABRIC_ID=abcdefgh

load all environment varibles in main.dart

import 'package:flutter_config/flutter_config.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // Required by FlutterConfig
  await FlutterConfig.loadEnvVariables();

  runApp(MyApp());
}

Now you can access your environment varibles anywhere in your app.

import 'package:flutter_config/flutter_config.dart';

FlutterConfig.get('FABRIC_ID') // returns 'abcdefgh'

Keep in mind this module doesn't obfuscate or encrypt secrets for packaging, so do not store sensitive keys in .env. It's basically impossible to prevent users from reverse engineering mobile app secrets, so design your app (and APIs) with that in mind.


Load Environment Varibles in Swift

First import the plugin

import flutter_config

Then you can use the .env Variable, replace ENV_API_KEY with yours.

flutter_config.FlutterConfigPlugin.env(for: "ENV_API_KEY")

Getting Started

Install the latest version of the plugin

Refer to Android Setup Guide for initial setup and advanced options

No additional setup is required for iOS, however, for advanced usage refer to the iOS Setup Guide

Testing

Whenever you need to use FlutterConfig in your tests, simply use the method loadValueForTesting

import 'package:flutter_config/flutter_config.dart';

void main() {
  FlutterConfig.loadValueForTesting({'BASE_URL': 'https://www.mockurl.com'});
  
  test('mock http client test', () {
    final client = HttpClient(
      baseUrl: FlutterConfig.get('BASE_URL')
    );
  });
}

Categorias

Repositório-fonte

Projetos que usam este pacote