Prérequis techniques

• Système d'exploitation : Windows
• JDK : version 21.0.11
• SDK Flutter : version 3.41.4
• Environnement de développement : Android Studio (Panda 2)

Procédure d'installation

Installation du SDK Flutter

Pour commencer, rendez-vous sur la page officielle de téléchargement de Flutter pour Windows. Sélectionnez l'archive ZIP correspondant à votre système. Décompressez-la dans un répertoire dont le chemin ne contient ni espaces ni caractères spéciaux, comme C:\Flutter.

Ajoutez ensuite le chemin du sous-dossier bin de votre installation Flutter à la variable d'environnement Path de votre utilisateur Windows. Pour ce faire, accédez aux propriétés système, puis aux paramètres de variables d'environnement.

Pour vérifier l'installation, ouvrez une invite de commande et exécutez :

# Vérification de la version de Flutter
flutter --version

En cas de lenteur ou d'erreur lors de cette première exécution, définissez deux nouvelles variables d'environnement utilisateur pour accélérer les téléchargements via des miroirs nationaux :

• PUB_HOSTED_URL avec la valeur https://pub.flutter-io.cn
• FLUTTER_STORAGE_BASE_URL avec la valeur https://storage.flutter-io.cn

Si le problème persiste, essayez des miroirs alternatifs comme ceux de Tencent Cloud.

Installation d'Android Studio

Téléchargez la dernière version d'Android Studio depuis le site des développeurs Android. Lancez l'installateur et suivez les étapes. Il est conseillé de choisir un répertoire d'installation différent de C:\Program Files pour éviter les restrictions de permissions.

Au premier lancement, si Android Studio ne parvient pas à accéder au SDK Android, deux solutions s'offrent à vous :

1. Ignorer l'erreur et configurer manuellement le chemin du SDK via Settings > Languages & Frameworks > Android SDK.
2. Configurer un proxy pendant l'installation en utilisant une adresse miroir, par exemple mirrors.aliyun.com sur le port 80.

Créez ensuite les variables d'environnement nécessaires :

• ANDROID_HOME pointant vers le dossier SDK, typiquement C:\Users\<utilisateur>\AppData\Local\Android\Sdk.
• Ajoutez à la variable Path les chemins %ANDROID_HOME%\platform-tools et %ANDROID_HOME%\tools.

Vérifiez la configuration en ligne de commande :

# Vérification de la version d'ADB
adb version

Installez les extensions Flutter et Dart dans Android Studio pour une intégration complète. Redémarrez l'IDE ensuite.

Pour valider l'environnement, exécutez dans le terminal intégré :

# Diagnostic complet de l'environnement Flutter
flutter doctor

Si des licences Android sont manquantes, acceptez-les via la commande flutter doctor --android-licenses.

Création et exécution d'un projet Flutter

Génération d'un nouveau projet

Dans Android Studio, créez un nouveau projet Flutter en spécifiant le chemin du SDK Flutter. Paramètres recommandés pour le projet :

• Nom du projet : choisissez un nom significatif.
• Emplacement : préférez un lecteur autre que C:\ pour le stockage.
• Langage Android : Kotlin ou Java selon votre préférence.
• Plateformes cibles : sélectionnez Android.

Optimisation de la configuration Gradle

Pour éviter l'encombrement du disque système, redirigez le cache de Gradle. Créez un dossier dédié, par exemple D:\Gradle-cache, et définissez la variable d'environnement GRADLE_USER_HOME avec ce chemin.

Modifiez le fichier gradle-wrapper.properties dans le projet pour utiliser un miroir de téléchargement rapide :

# Remplacez l'URL de distribution par un miroir, par exemple :
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.0-bin.zip

Exécution sur un émulateur

Dans Android Studio, accédez au Device Manager pour créer un émulateur virtuel. Choisissez un modèle de périphérique, téléchargez l'image système requise et lancez l'émulateur.

Une fois l'émulateur actif, sélectionnez-le dans la barre d'outils supérieure et exécutez le fichier main.dart de votre projet. Le premier lancement peut prendre plusieurs minutes en raison de la compilation.

Exécution sur un appareil physique Android

Pour tester sur un téléphone réel :

1. Activez les options développeur dans les paramètres de l'appareil en tapotant sept fois sur le numéro de build.
2. Dans les options développeur, activez le débogage USB.
3. Connectez l'appareil via USB et sélectionnez-le comme cible de déploiement dans Android Studio.

Analyse de la structure du projet

Un projet Flutter généré contient plusieurs répertoires clés :

• lib : code source Dart de l'application.
• android : configuration native pour Android.
• ios : configuration native pour iOS (non couverte dans ce tutoriel).
• test : fichiers de test unitaire.

Accès aux variables d'environnement Windows

Pour modifier les variables d'environnement système :

1. Faites un clic droit sur Ce PC et choisissez Propriétés.
2. Cliquez sur Paramètres système avancés.
3. Sous l'onglet Avancé, cliquez sur Variables d'environnement.