À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer dans AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Configuration de l'organisation

Si vous configurez Cloud Workstations pour une organisation, vous pouvez créer une configuration de station de travail utilisateur avec du code pré-téléchargé et précompilé. Les développeurs peuvent ainsi commencer à travailler immédiatement sans attendre la fin du processus de compilation.

Pour créer une configuration de poste de travail utilisateur, vous devez créer un poste de travail administrateur, exécuter le processus de compilation une fois, créer un instantané du disque persistant, puis utiliser cet instantané pour créer une configuration de poste de travail.

Créer un poste de travail d'administrateur

Suivez la procédure décrite dans Lancer la station de travail pour créer et lancer une seule station de travail. Elle servira d'image de base.

Créer les cibles

Sur le poste de travail administrateur, téléchargez le code source et créez les cibles. Vous pouvez créer manuellement les cibles ou automatiser la création à l'aide du script fourni.

Compilation manuelle

Avant d'exécuter le script de compilation, accédez au code comme décrit dans Accès au code source. Ensuite, compilez manuellement les cibles comme décrit dans Télécharger, compiler et exécuter.

Compilation automatique

Exécutez le script setup.sh fourni dans le dépôt sdv-setup. Ce script automatise le clonage du code source Android et la création des cibles.

Ouvrez un terminal sur le poste de travail.

Définissez vos identifiants Git :

git config --global user.email "Your email address"
git config --global user.name "Your name"

S'authentifier auprès de partner-android.googlesource.com :
1. Connectez-vous à partner-android-review.googlesource.com avec votre compte partenaire Android.
2. Accédez à Paramètres, puis sélectionnez Profil.
3. Accédez à la section Identifiants HTTP, puis cliquez sur Obtenir le mot de passe.
4. Suivez les instructions à l'écran, puis collez le script d'authentification dans le terminal de la station de travail. Cette opération crée le fichier ~/.gitcookies, qui est requis pour l'accès.

Exécutez le script de configuration en procédant comme suit :

Suivez la procédure d'authentification décrite dans Obtenir l'accès. Vous pouvez ainsi accéder au dépôt de scripts de configuration.
Clonez le dépôt sdv-setup, puis exécutez le script de configuration :

# Change directories to the home directory
cd ~/

# Clone the sdv-setup repository
git clone https://sdv.googlesource.com/external/sdv-setup

# Ensure the setup script is executable
chmod +x sdv-setup/setup/setup.sh

# Run the setup script
./sdv-setup/setup/setup.sh

L'exécution du script prend plusieurs heures. Il clone le code source Android (environ 30 minutes), puis crée les cibles SDV IVI (2 heures), Media (30 minutes) et Core (10 minutes).

(Facultatif) Configurer un projet Android Studio for Platform

Android Studio for Platform (ASfP) est un IDE préinstallé sur la station de travail cloud. Si tous vos développeurs travaillent sur le même projet, vous pouvez configurer un projet ASfP dans l'instantané de disque que tout le monde peut utiliser. Suivez les instructions de la section Configurer un projet AAOS SDV pour configurer le projet.

Créer un instantané de disque

Une fois la compilation terminée, créez un instantané du disque persistant du poste de travail administrateur.

Supprimez votre configuration Git et vos cookies pour éviter de partager vos identifiants personnels avec d'autres utilisateurs :
```
rm ~/.gitcookies
rm ~/.gitconfig
```
Supprimez le dépôt sdv-setup pour que l'image de base reste propre :
```
rm -rf ~/sdv-setup
```
Recherchez le disque du poste de travail administrateur :
1. Maintenez le poste de travail administrateur en cours d'exécution.
2. Dans la console Google Cloud, saisissez VM Instances dans la barre de recherche, puis cliquez sur le premier résultat.
3. Dans la barre Filtre, saisissez workstation_id:work-station. work-station doit correspondre à l'ID de votre poste de travail administrateur. Appuyez sur Entrée pour filtrer les résultats.
4. Cliquez sur l'entrée restante.
5. Sur la page de l'instance de VM, deux disques différents sont listés sous Stockage. Cliquez sur le disque dont la Taille (Go) est définie sur 1000 et le Type sur Disque persistant SSD régional. Ce disque contient le répertoire personnel dont vous souhaitez créer un instantané.
Arrêtez le poste de travail administrateur :
1. Laissez la page du disque ouverte.
2. Dans un nouvel onglet ou une nouvelle fenêtre de navigateur, ouvrez la console Google Cloud et accédez à la page "Cloud Workstations". Dans la barre de recherche, saisissez Cloud Workstations, puis cliquez sur le premier résultat.
3. Cliquez sur Stations de travail dans le panneau latéral.
4. Cliquez sur le poste de travail administrateur (avec l'ID work-station) dans le tableau.
5. Cliquez sur Arrêter dans la barre d'outils, puis attendez que la station de travail s'arrête.
Avertissement : Si vous ne mettez pas fin à la session du poste de travail avant de créer l'instantané du disque, vous risquez de corrompre les données de l'instantané.
Créez l'instantané de disque :
1. Revenez à la page du disque, puis cliquez sur Créer un instantané dans la barre d'outils.
2. Dans le champ Nom, saisissez aaos-sdv-dev-snapshot.
3. Conservez les valeurs par défaut des autres champs.
4. Au bas de la page, cliquez sur Créer.

Au bout de quelques instants, l'instantané du disque est créé et prêt à être utilisé.

Créer la configuration de la station de travail de l'utilisateur

Créez une configuration de station de travail qui utilise l'instantané comme point de départ :

Suivez les instructions de la section Définir des variables d'environnement pour lancer Cloud Shell, puis définissez les variables d'environnement.
Appliquez la configuration Terraform pour créer la configuration du poste de travail utilisateur :
```
cd ~/dev/sdv-setup/tf/user_dev_env
terraform init
terraform apply -auto-approve
```

Créer un poste de travail utilisateur

Dans la console Google Cloud, accédez à la page "Cloud Workstations". Saisissez Cloud Workstations dans la barre de recherche, puis cliquez sur le premier résultat.
Cliquez sur Stations de travail dans le panneau latéral.
Cliquez sur Créer une station de travail dans la barre d'outils.
Saisissez un ID pour la station de travail ou conservez la valeur par défaut.
Saisissez un nom à afficher pour le poste de travail. Si vous laissez ce champ vide, l'ID est utilisé.
Sélectionnez user-workstation-config comme Configuration.
Cliquez sur Créer.
Dans la liste des stations de travail, recherchez celle que vous venez de créer. Cliquez sur Démarrer dans la colonne Actions rapides.
Une fois la station de travail démarrée, cliquez sur Lancer dans la colonne Actions rapides pour commencer à l'utiliser.
Ouvrez un explorateur de fichiers pour vérifier que le répertoire d'accueil contient les fichiers de l'instantané du disque.

Votre organisation peut désormais créer des stations de travail pour ses développeurs. Pour en savoir plus sur la configuration de l'accès à Cloud Workstations, consultez Contrôle des accès avec IAM.