Basics

Icone dell'App

Introduzione

Nylo Website v7 utilizza flutter_launcher_icons per generare le icone dell'app per iOS e Android da una singola immagine sorgente.

L'icona della tua app dovrebbe essere posizionata nella directory assets/app_icon/ con una dimensione di 1024x1024 pixel.

Generare le Icone dell'App

Esegui il seguente comando per generare le icone per tutte le piattaforme:

dart run flutter_launcher_icons

Questo legge la tua icona sorgente da assets/app_icon/ e genera:

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

Aggiungere la Tua Icona dell'App

  1. Crea la tua icona come file PNG 1024x1024
  2. Posizionala in assets/app_icon/ (es. assets/app_icon/icon.png)
  3. Aggiorna il image_path nel tuo pubspec.yaml se necessario:
flutter_launcher_icons:
  android: true
  ios: true
  image_path: "assets/app_icon/icon.png"
  1. Esegui il comando di generazione delle icone

Requisiti dell'Icona dell'App

Attributo Valore
Formato PNG
Dimensione 1024x1024 pixel
Livelli Appiattiti senza trasparenza

Denominazione dei File

Mantieni i nomi dei file semplici senza caratteri speciali:

  • app_icon.png
  • icon.png

Linee Guida della Piattaforma

Per requisiti dettagliati, consulta le linee guida ufficiali della piattaforma:

Configurazione

Personalizza la generazione delle icone nel tuo pubspec.yaml:

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

Consulta la documentazione di flutter_launcher_icons per tutte le opzioni disponibili.

Conteggio Badge

Nylo Website fornisce funzioni helper per gestire il conteggio dei badge dell'app (il numero mostrato sull'icona dell'app):

import 'package:nylo_framework/nylo_framework.dart';

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

// Clear the badge count
await clearBadgeNumber();

Supporto Piattaforma

I conteggi badge sono supportati su:

  • iOS: Supporto nativo
  • Android: Richiede il supporto del launcher (la maggior parte dei launcher lo supporta)
  • Web: Non supportato

Casi d'Uso

Scenari comuni per i conteggi badge:

  • Notifiche non lette
  • Messaggi in sospeso
  • Articoli nel carrello
  • Attivita' incomplete
// 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();
}