Buscar pacotes, repositórios e categorias de apps

Capa de flutter_flavor
Detalhes do pacotev3.1.4

flutter_flavor

Podemos criar diferentes sabores e, assim, ter instâncias diferentes do nosso aplicativo antes de publicá-lo na App Store e no Google Play.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
33,5 mil
Curtidas
479
Pontos Pub
160

Instalar pacote

flutter pub add flutter_flavor

Visão geral do pacote

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

flutter_flavor é uma ferramenta para desenvolvedores que permite a criação de diferentes sabores de aplicativos, permitindo configurações e compilações distintas para vários ambientes — como desenvolvimento, homologação e produção — antes de publicar nas lojas de aplicativos. Ela simplifica a gestão de configurações específicas por ambiente, como endpoints de API, níveis de log e branding, sem duplicar código. O pacote se integra perfeitamente ao sistema de build do Flutter em todas as plataformas suportadas, incluindo Android, iOS, Web, macOS, Windows e Linux. Ajuda equipes a manter fluxos de trabalho limpos e configuráveis para testes e implantação.

Casos de uso

  • Gerenciando múltiplos ambientes
  • Personalizando configurações de compilação
  • Testes antes do lançamento
  • Separando configurações de dev/estaging/prod
  • Simplificando pipelines de CI/CD

Principais recursos

  • Configuração específica do ambiente
  • Suporte multiplataforma
  • Integração fácil com o Flutter
  • Diferenciação de sabor em tempo de compilação
  • Boilerplate mínimo

Indicado para

  • Equipes de desenvolvimento
  • workflows de CI/CD
  • Aplicativos multiambiente
  • Personalização de aplicativo por versão
  • Equipes usando diferentes estágios de implantação

Considerações

  • Requer configuração em scripts de compilação
  • Os nomes dos sabores devem ser consistentes entre plataformas
  • mudança de tempo de execução limitada
  • Não destinado à seleção de sabor voltada para o usuário
  • Necessita coordenação entre os membros da equipe

README original

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

flutter_flavor

pub package Star on Github License: MIT

Flavors helps us to create builds for different instances of our app. For example, we can create a flavor for development, a flavor for production and another flavor for a demo of the app. In this way we can create different flavors, and thus have different instances of our apps before publishing it on the App Store and Google Play.

flutter_favor allows you to quickly configure and define dynamic variables for each flavor in your project. The flavors, as well as their names; they are dynamically defined by the developer or development team. In the configuration of a flavor you can set the name of each flavor, as well as the color and location of its banner. When attribute name is undefined or empty, the banner is hidden.

You can also configure the banners independently. The aforementioned attributes are globally configured in FlavorConfig, but can be changed in the FlavorBanner.

Screenshot

PROD DEV TEST
Screenshot Prod Screenshot Dev Screenshot Test

Note By default the banner is shown in BannerLocation.topStart and is visibility only when the attribute name of configuration is defined and not empty.

Getting Started

Adding package
flutter_flavor: ^3.1.4
Importing package
import 'package:flutter_flavor/flutter_flavor.dart';
Configuring
FlavorConfig(
    name: "DEVELOP",
    color: Colors.red,
    location: BannerLocation.bottomStart,
    variables: {
        "counter": 0,
        "baseUrl": "https://www.example.com",
    }
);
Using variables
 int _counter = FlavorConfig.instance.variables["counter"];

Example

Main
import 'package:flutter/material.dart';
import 'package:flutter_flavor/flutter_flavor.dart';

import 'app.dart';

void main() {
  FlavorConfig(
    name: "DEVELOP",
    color: Colors.red,
    location: BannerLocation.topStart,
    variables: {
      "counter": 5,
      "baseUrl": "https://www.example2.com",
    },
  );

  runApp(const MyApp());
}
App
import 'package:flutter/material.dart';
import 'package:flutter_flavor/flutter_flavor.dart';

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return FlavorBanner(
      child: MaterialApp(
        title: 'Flutter Demo',
        theme: ThemeData(
          colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
          useMaterial3: true,
        ),
        home: const MyHomePage(title: 'Flutter Demo Home Page'),
      ),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});
  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            const Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}

VSCode Configuration

The .vscode folder is created in the workspace, if it does not exist it can be created by hand. Inside that folder a launch.json file is created and the configuration is established inside the file. For more information, visit: https://code.visualstudio.com/docs/editor/debugging and https://go.microsoft.com/fwlink/?linkid=830387

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "PROD-Flavor",
      "program": "[project-folder]/lib/main_prod.dart",
      "request": "launch",
      "type": "dart"
    },
    {
      "name": "DEV-Flavor",
      "program": "[project-folder]/lib/main_dev.dart",
      "request": "launch",
      "type": "dart"
    }
  ]
}

License

MIT License

Categorias

Repositório-fonte

Projetos que usam este pacote