Buscar pacotes, repositórios e categorias de apps

Capa de flavor
Detalhes do pacotev2.0.0

flavor

Uma maneira fácil de configurar configurações de sabor e exibir o banner de sabor.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
1 mil
Curtidas
56
Pontos Pub
160

Instalar pacote

flutter pub add flavor

Visão geral do pacote

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

Flavor é um pacote Flutter que simplifica a configuração de sabores do aplicativo e exibe uma faixa visível de sabor em builds de depuração. Ele permite que os desenvolvedores diferenciem facilmente entre diferentes variantes de build — como desenvolvimento, staging e produção — mostrando uma faixa personalizável na tela. A faixa é automaticamente oculta em builds de release, garantindo uma experiência de usuário limpa. Ideal para equipes que gerenciam múltiplos ambientes, ele simplifica a configuração e melhora a visibilidade durante os testes.

Casos de uso

  • Depuração de diferentes ambientes de compilação
  • Identificando builds de desenvolvimento versus produção
  • Exibindo informações do ambiente durante os testes
  • Personalizando banners por sabor
  • Melhorando a colaboração da equipe em projetos multiambiente

Principais recursos

  • Configuração fácil de sabor
  • Exibição automática do banner no modo de depuração
  • Aparência personalizável do banner
  • Suporta todas as plataformas do Flutter
  • Esconde o banner em compilações de lançamento

Indicado para

  • Desenvolvedores trabalhando com múltiplas versões de aplicativos
  • Equipes testando diferentes ambientes
  • Aplicativos que exigem identificação clara de compilação
  • Projetos Flutter com pipelines de CI/CD
  • Projetos que precisam de feedback visual durante o desenvolvimento

Considerações

  • O banner só aparece em compilações de depuração
  • Requer configuração manual para novos sabores
  • Pode ser necessário ajustes de estilo para interfaces complexas
  • Não destinado ao uso em produção
  • Personalização limitada além das propriedades básicas do banner

README original

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

flavor

pub package build Buy Me A Coffee

A Flutter plugin for configuring flavor settings and optionally display a flavor banner on the app.

Flavors

Each app needs some kind of flavor during its development lifecycle. You often have an api you use that is different during dev, beta, production, or log settings for example. That's when flavors come in.

Setup flavors

You can define different start main methods, each can be configured with a flavor.

So for example, you can create a main_dev.dart file for your development environment:

void main() {
  Flavor.create(
    Environment.dev,
    color: Colors.green,
    name: 'PREVIEW',
    properties: {
      Keys.apiUrl: 'https://api.dev.company.com',
      Keys.apiKey: 'jksdhfkjhs83rjkh324kj23h4',
      logLevelKey: 100,
    },
  );
  setupApp();
}

And a main_prod.dart file for your production environment:

void main() {
  Flavor.create(
    Environment.production,
    properties: {
      Keys.apiUrl: 'https://api.company.com',
      Keys.apiKey: 'lksdhjfkjhdsf8sdfjkhsdf896',
      logLevelKey: 5,
    },
  );
  setupApp();
}

Each of these files will point to another main.dart file:

void setupApp() {
  final logLevel = Flavor.I.getInt(logLevelKey);
  print('LogLevel set for this flavor: $logLevel');
  runApp(FlavorApp());
}
How does it look?
DEV BETA PROD

Note that in the PROD flavor no flavor banner is showed.

launch.json

In Visual Code you can define following to use the different flavors:

{
	"version": "0.2.0",
	"configurations": [
		{
			"name": "DEV",
			"request": "launch",
			"type": "dart",
			"program": "example/lib/main_dev.dart",
			// "args": [
			// 	"--flavor",
			// 	"dev"
			// ]
		},
		{
			"name": "BETA",
			"request": "launch",
			"type": "dart",
			"program": "example/lib/main_beta.dart",
			// "args": [
			// 	"--flavor",
			// 	"beta"
			// ]
		},
		{
			"name": "PRD",
			"request": "launch",
			"type": "dart",
			"program": "example/lib/main_prod.dart",
			// "args": [
			// 	"--flavor",
			// 	"prod"
			// ]
		},
	]
}

Note: The args keys are currently commented. These only works if you created the flavors in the iOS / Android native projects too.

Extras

You can also define additional properties for each flavor/configuration. This is handy to store url's, api keys, etc. Further in your app you can access these values.

Flavor.I.getString(Keys.apiUrl)

The package has some default Keys at the moment which will be extended over time. The defaults: apiUrl, apiKey, appTitle

Of course you can add custom keys yourself as showed in the example.

Or you can check what flavor is currently running:

if (Flavor.I.isDevelopment) {
// do something nice in development
}

Checkout the example folder for a complete setup.

Flavorize your bundleids and assets

If you want to change bundle ids, or even assets (icon, splash screen) check out flutter_flavorizr. This nice tool will help you create flavors in Android and iOS.

API Documentation

API documentation can be found here

Categorias

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.