Android Studio for Platform (ASfP) vous aide à configurer votre environnement de développement pour le projet Android Open Source (AOSP). Basé sur le modèle d'espace de travail IntelliJ, ASfP est compatible avec la configuration manuelle et les modèles d'équipe partageables.
Lancer l'assistant de configuration du projet
Vous pouvez lancer l'assistant de configuration de projet de deux manières :
- Sur l'écran d'accueil : cliquez sur Nouveau projet ou Importer un projet ASfP.
- À partir d'un projet ouvert : dans le menu principal, sélectionnez ASfP > Projet > Nouveau projet ou Importer un projet ASfP.
Importer à partir d'un modèle
Si votre équipe partage un fichier de configuration .asfp-project standard, vous pouvez initialiser votre espace de travail directement à partir de ce modèle :
- Dans l'assistant de configuration du projet, sélectionnez Importer à partir d'un modèle.
- Accédez au fichier YAML
.asfp-projectou.asfp-templatepartagé, puis sélectionnez-le. - Une fois que l'assistant a rempli les paramètres du projet à partir du modèle, vérifiez le chemin d'accès à l'extraction du dépôt local, puis cliquez sur Terminer.
Configurer manuellement
Pour créer une configuration de projet de toutes pièces :
Dans l'assistant de configuration du projet, choisissez de configurer le projet manuellement et renseignez les détails du projet :
- Extraction du dépôt (chemins d'accès aux modules) : spécifiez le chemin absolu à la racine de votre extraction locale de la source AOSP (par exemple,
/path/to/aosp). - Cible de déjeuner : saisissez la cible de déjeuner que vous utilisez pour la création (par exemple,
aosp_cf_x86_64_phone-aosp_current-userdebug). - Nom du projet : donnez un nom descriptif à votre projet.
- Répertoires et modules : listez les répertoires ou modules Soong initiaux à inclure dans votre projet (par rapport à la racine du dépôt, comme
frameworks/baseoupackages/apps/Settings). - Langages : si votre workflow inclut du code de plate-forme C, C++ ou Rust, sélectionnez C ou C++ ou Rust. Java, Kotlin et
Android.bpsont inclus par défaut. - Variables d'environnement et options de compilation : dans le champ Variables d'environnement de l'assistant, ajoutez des variables d'environnement personnalisées telles que
SOONG_ALLOW_MISSING_DEPENDENCIES=true, et cochez éventuellement la case Compilation partielle Soong (SOONG_PARTIAL_COMPILE) pour des compilations incrémentielles plus rapides.
- Extraction du dépôt (chemins d'accès aux modules) : spécifiez le chemin absolu à la racine de votre extraction locale de la source AOSP (par exemple,
Cliquez sur Terminer. ASfP crée la structure du projet, génère le fichier de configuration
.asfp-projectà la racine de votre projet et exécute la synchronisation initiale.
Partager ou personnaliser la configuration de votre projet
Après la configuration initiale, vous pouvez personnaliser votre projet à tout moment en modifiant le fichier .asfp-project (ASfP > Projet > Ouvrir la configuration) :
- Ajoutez ou excluez des répertoires et des modules Soong.
- Activez d'autres langues (
cpp,rust). - Configurez des indicateurs Soong et des variables d'environnement personnalisés.
Pour exporter votre configuration pour vos coéquipiers, effectuez un clic droit sur l'onglet .asfp-project et sélectionnez Exporter vers un modèle.
Pour en savoir plus sur les paramètres .asfp-project, les modes de synchronisation et les actions Android.bp dans l'éditeur, consultez Présentation des projets et workflows Soong.