Démarrage rapide : Préparer la plate-forme d'appareils pour les développeurs
Configurez-vous pour utiliser la plate-forme d'appareils pour les développeurs, une suite de nouvelle génération de qualité commerciale pour l'orchestration d'appareils à distance.
Avant de commencer
La plate-forme d'appareils pour les développeurs fonctionne sur n'importe quelle station de travail disposant d'un terminal et d'un accès à Internet, en suivant les instructions de cette page.
Ces documents supposent que vous êtes un Google Cloud utilisateur avec des projets et des comptes, comme décrit dans Premiers pas avec Google Cloud qui se trouve dans l' Présentation tab de ce site.
Google Cloud : configuration
- Connectez-vous à votre Google Cloud compte. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.
-
Installez la Google Cloud CLI.
-
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
-
Pour initialiser la gcloud CLI, exécutez la commande suivante :
gcloud init -
Vérifiez que vous disposez des autorisations requises pour suivre les instructions de ce guide.
-
Vérifiez que la facturation est activée pour votre Google Cloud projet.
Activez les API Device Run, Device Streaming et Cloud Testing :
Rôles requis pour activer les API
Pour activer les API, vous avez besoin de l'autorisation
serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.gcloud services enable devicerun.googleapis.com
devicestreaming.googleapis.com testing.googleapis.com -
Si vous utilisez un shell local, créez des identifiants d'authentification locaux pour votre compte utilisateur : Créer des identifiants d'authentification locaux pour votre compte utilisateur :
gcloud auth application-default login
Vous n'avez pas besoin de le faire si vous utilisez Cloud Shell.
Si une erreur d'authentification est renvoyée et que vous utilisez un fournisseur d'identité (IdP) externe, vérifiez que vous vous êtes connecté à la gcloud CLI avec votre identité fédérée.
-
Installez la Google Cloud CLI.
-
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
-
Pour initialiser la gcloud CLI, exécutez la commande suivante :
gcloud init -
Vérifiez que vous disposez des autorisations requises pour suivre les instructions de ce guide.
-
Vérifiez que la facturation est activée pour votre Google Cloud projet.
Activez les API Device Run, Device Streaming et Cloud Testing :
Rôles requis pour activer les API
Pour activer les API, vous avez besoin de l'autorisation
serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.gcloud services enable devicerun.googleapis.com
devicestreaming.googleapis.com testing.googleapis.com -
Si vous utilisez un shell local, créez des identifiants d'authentification locaux pour votre compte utilisateur : Créer des identifiants d'authentification locaux pour votre compte utilisateur :
gcloud auth application-default login
Vous n'avez pas besoin de le faire si vous utilisez Cloud Shell.
Si une erreur d'authentification est renvoyée et que vous utilisez un fournisseur d'identité (IdP) externe, vérifiez que vous vous êtes connecté à la gcloud CLI avec votre identité fédérée.
Rôles requis
Pour obtenir les autorisations nécessaires pour utiliser la plate-forme d'appareils pour les développeurs, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :
-
Tous :
- Lecteur de rôles (
roles/viewer) - Administrateur Device Run (
roles/devicerun.googleapis.com/admin) - Administrateur Device Streaming (
roles/devicestreaming.admin) - Consommateur Service Usage (
roles/serviceusage.serviceUsageConsumer)
- Lecteur de rôles (
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Exemples de commandes
Maintenant que vous disposez du service Device Run, vous pouvez exécuter les commandes suivantes pour essayer le catalogue.
Commencez par répertorier tous les appareils de votre projet :
gcloud device-run devices list
Ensuite, répertoriez toutes les sessions de votre projet (probablement aucune) :
gcloud device-run sessions
Passez maintenant aux instructions concernant les fonctionnalités sous Étape suivante ou suivez la section suivante pour utiliser la compétence d'agent de la plate-forme d'appareils pour les développeurs.
Installer la compétence d'agent de la plate-forme d'appareils pour les développeurs
En plus d'établir l' Google Cloud environnement décrit sur cette page, vous devrez installer les packages suivants pour la compétence d'agent de la plate-forme d'appareils pour les développeurs :
- ADB pour exécuter des commandes sur l' appareil Android à distance
- un environnement Python pour activer le transfert ADB
- Antigravity ou tout autre agent de codage IA compatible avec les compétences d'agent
- Node.js et le package NPM
pour installer la compétence d'agent à l'aide de
npx
Installez maintenant la compétence d'agent de la plate-forme d'appareils pour les développeurs avec :
npx skills add https://github.com/google/skills --skill developer-device-platform-basics
Passez maintenant aux instructions concernant les fonctionnalités sous "Étape suivante".
Pièces justificatives
Libérer de l'espace
Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre Google Cloud compte pour les ressources utilisées sur cette page, supprimez le Google Cloud projet qui les contient.
Étape suivante
- Catalogue d'appareils : décrivez tous les types d'appareils du laboratoire DDP et examinez chaque type.
- Device Run : exécutez des tests sur les appareils du laboratoire DDP et consultez les résultats dans. Google Cloud
- API Device Streaming : connectez-vous à des appareils Android physiques à distance et interagissez avec votre application comme si elle était connectée à votre machine locale.
- Développement agentique avec Device Streaming : utilisez la compétence d'agent de la plate-forme d'appareils pour les développeurs afin de trouver, de réserver et de vous connecter à des appareils dans DDP.