Panduan memulai: Bersiap untuk Platform Perangkat Developer

Siapkan penggunaan Developer Device Platform, rangkaian alat generasi berikutnya dan tingkat komersial untuk orkestrasi perangkat jarak jauh.

Sebelum memulai

Platform Perangkat Developer berfungsi di workstation mana pun dengan terminal dan akses internet dengan mengikuti petunjuk di halaman ini.

Dokumen ini mengasumsikan bahwa Anda adalah pengguna Google Cloud dengan project dan akun, seperti yang dijelaskan dalam Mulai menggunakan Google Cloud yang ada di tab Ringkasan situs ini.

KonfigurasiGoogle Cloud

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

  2. Instal Google Cloud CLI.

  3. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  4. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  5. Pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini.

  6. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  7. Aktifkan Device Run, Device Streaming, Cloud Testing API:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran. 

    gcloud services enable devicerun.googleapis.com devicestreaming.googleapis.com testing.googleapis.com

  8. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

    gcloud auth application-default login

    Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

    Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

  9. Instal Google Cloud CLI.

  10. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  11. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  12. Pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini.

  13. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  14. Aktifkan Device Run, Device Streaming, Cloud Testing API:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran. 

    gcloud services enable devicerun.googleapis.com devicestreaming.googleapis.com testing.googleapis.com

  15. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

    gcloud auth application-default login

    Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

    Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan Platform Perangkat Developer, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Contoh perintah

Setelah memiliki layanan Device Run, Anda dapat menjalankan perintah berikut untuk mencoba katalog.

Pertama, cantumkan semua perangkat dalam project Anda:

gcloud device-run devices list

Selanjutnya, cantumkan semua sesi dalam project Anda (kemungkinan tidak ada):

gcloud device-run sessions

Sekarang, lanjutkan ke petunjuk fitur di bagian Langkah berikutnya atau ikuti bagian berikutnya untuk menggunakan keterampilan agen Platform Perangkat Developer.

Menginstal keahlian agen Developer Device Platform

Selain menyiapkan Google Cloud lingkungan yang dijelaskan di halaman ini, Anda harus menginstal paket berikut untuk kemampuan agen Developer Device Platform:

  • ADB untuk menjalankan perintah di perangkat Android jarak jauh
  • Lingkungan Python untuk mengaktifkan penerusan ADB
  • Antigravity atau agen pengodean AI lainnya yang mendukung keterampilan agen
  • Node.js dan paket NPM untuk menginstal kemampuan agen menggunakan npx

Sekarang instal kemampuan agen Developer Device Platform dengan:

npx skills add https://github.com/google/skills --skill developer-device-platform-basics

Sekarang, lanjutkan ke petunjuk fitur di bagian Apa selanjutnya.

Dokumentasi pendukung

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, hapus project Google Cloud yang berisi resource tersebut.

Langkah berikutnya

  • Katalog Perangkat - Mendeskripsikan semua jenis perangkat di lab DDP dan mempelajari setiap jenis
  • Device Run - Jalankan pengujian di perangkat di lab DDP dan lihat hasilnya di Google Cloud
  • Device Streaming API - Terhubung ke perangkat Android fisik jarak jauh dan berinteraksi dengan aplikasi Anda seolah-olah terhubung ke mesin lokal Anda
  • Pengembangan Agentik dengan Streaming Perangkat - Menggunakan kemampuan agen Developer Device Platform untuk menemukan, memesan, dan menghubungkan ke perangkat di DDP