Pakete, Repositories und App-Kategorien suchen

Cover von flavor
Paketdetailsv2.0.0

flavor

Eine einfache Möglichkeit, Geschmacks-Einstellungen zu konfigurieren und Geschmacks-Banner anzuzeigen.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
1040
Likes
56
Pub-Punkte
160

Paket installieren

flutter pub add flavor

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Flavor ist ein Flutter-Paket, das die Konfiguration von App-Flavors vereinfacht und in Debug-Builds eine sichtbare Flavor-Banner anzeigt. Es ermöglicht Entwicklern, verschiedene Build-Varianten – wie Entwicklung, Staging und Produktion – leicht voneinander zu unterscheiden, indem es eine anpassbare Banner auf dem Bildschirm anzeigt. Der Banner wird automatisch in Release-Builds ausgeblendet, um ein sauberes Benutzererlebnis zu gewährleisten. Ideal für Teams, die mehrere Umgebungen verwalten, vereinfacht es die Einrichtung und verbessert die Sichtbarkeit während des Testens.

Anwendungsfälle

  • Debugging verschiedener Build-Umgebungen
  • Entwicklung vs. Produktionsbuilds identifizieren
  • Anzeigen von Umgebungsinfo während des Testens
  • Banner je nach Geschmack anpassen
  • Verbesserung der Teamzusammenarbeit bei mehrumgebungsbasierten Projekten

Hauptmerkmale

  • Einfache Geschmackskonfiguration
  • Automatische Banner-Anzeige im Debug-Modus
  • Anpassbare Banner-Aussehen
  • Unterstützt alle Flutter-Plattformen
  • Versteckt Banner in Release-Builds

Geeignet für

  • Entwickler, die mit mehreren App-Flavors arbeiten
  • Teams testen verschiedene Umgebungen
  • Apps, die eine klare Build-Identifikation erfordern
  • Flutter-Projekte mit CI/CD-Pipelines
  • Projekte, die visuelle Rückmeldung während der Entwicklung benötigen

Hinweise

  • Die Banner erscheinen nur in Debug-Builds
  • Benötigt manuelle Einrichtung für neue Geschmacksrichtungen
  • Könnte stilistische Anpassungen für komplexe Benutzeroberflächen erfordern
  • Nicht für den Produktiveinsatz vorgesehen
  • Begrenzte Anpassungsmöglichkeiten über die grundlegenden Banner-Eigenschaften hinaus

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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

Kategorien

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.