Basics

App-Icons

Einleitung

Nylo Website v7 verwendet flutter_launcher_icons, um App-Icons für iOS und Android aus einem einzigen Quellbild zu generieren.

Ihr App-Icon sollte im Verzeichnis assets/app_icon/ abgelegt werden und eine Größe von 1024x1024 Pixeln haben.

App-Icons generieren

Führen Sie den folgenden Befehl aus, um Icons für alle Plattformen zu generieren:

dart run flutter_launcher_icons

Dieser Befehl liest Ihr Quell-Icon aus assets/app_icon/ und generiert:

  • iOS-Icons in ios/Runner/Assets.xcassets/AppIcon.appiconset/
  • Android-Icons in android/app/src/main/res/mipmap-*/

Eigenes App-Icon hinzufügen

  1. Erstellen Sie Ihr Icon als 1024x1024 PNG-Datei
  2. Platzieren Sie es in assets/app_icon/ (z.B. assets/app_icon/icon.png)
  3. Aktualisieren Sie bei Bedarf den image_path in Ihrer pubspec.yaml:
flutter_launcher_icons:
  android: true
  ios: true
  image_path: "assets/app_icon/icon.png"
  1. Führen Sie den Befehl zur Icon-Generierung aus

Anforderungen an App-Icons

Eigenschaft Wert
Format PNG
Größe 1024x1024 Pixel
Ebenen Flach ohne Transparenz

Dateibenennung

Halten Sie Dateinamen einfach und ohne Sonderzeichen:

  • app_icon.png
  • icon.png

Plattform-Richtlinien

Für detaillierte Anforderungen beachten Sie die offiziellen Plattform-Richtlinien:

Konfiguration

Passen Sie die Icon-Generierung in Ihrer pubspec.yaml an:

flutter_launcher_icons:
  android: true
  ios: true
  image_path: "assets/app_icon/icon.png"

  # Optional: Use different icons per platform
  # image_path_android: "assets/app_icon/android_icon.png"
  # image_path_ios: "assets/app_icon/ios_icon.png"

  # Optional: Adaptive icons for Android
  # adaptive_icon_background: "#ffffff"
  # adaptive_icon_foreground: "assets/app_icon/foreground.png"

  # Optional: Remove alpha channel for iOS
  # remove_alpha_ios: true

Siehe die flutter_launcher_icons Dokumentation für alle verfügbaren Optionen.

Badge-Zähler

Nylo Website bietet Hilfsfunktionen zur Verwaltung von App-Badge-Zählern (die auf dem App-Icon angezeigte Zahl):

import 'package:nylo_framework/nylo_framework.dart';

// Set badge count to 5
await setBadgeNumber(5);

// Clear the badge count
await clearBadgeNumber();

Plattformunterstützung

Badge-Zähler werden unterstützt auf:

  • iOS: Native Unterstützung
  • Android: Erfordert Launcher-Unterstützung (die meisten Launcher unterstützen dies)
  • Web: Nicht unterstützt

Anwendungsfälle

Häufige Szenarien für Badge-Zähler:

  • Ungelesene Benachrichtigungen
  • Ausstehende Nachrichten
  • Artikel im Warenkorb
  • Unerledigte Aufgaben
// Example: Update badge when new messages arrive
void onNewMessage() async {
  int unreadCount = await MessageService.getUnreadCount();
  await setBadgeNumber(unreadCount);
}

// Example: Clear badge when user views messages
void onMessagesViewed() async {
  await clearBadgeNumber();
}