L'emulatore per sviluppatori Google Play Giochi su PC è un emulatore dedicato agli sviluppatori per Google Play Giochi su PC. A differenza dell'esperienza con il player, puoi installare eseguire il debug dei tuoi pacchetti. Puoi anche simulare diverse configurazioni del player come proporzioni, emulazione del mouse e backend grafico, assicurati che le prestazioni del gioco siano quelle previste su vari PC configurazioni.
Avvio dell'emulatore
Una volta installato, avrai a disposizione un "Emulatore per gli sviluppatori di Google Play Giochi" avvia un elemento di menu e un collegamento sul desktop per avviare l'emulatore. L'emulatore rimangono nella barra delle applicazioni quando chiudi la finestra.
Accedi
Ti viene chiesto di accedere al tuo Account Google la prima volta che esegui un emulatore. Utilizza le stesse credenziali di accesso che prevedi di usare per lo sviluppo.
Per uscire, fai clic con il tasto destro del mouse sull'icona della barra delle applicazioni e seleziona Opzioni per sviluppatori Opzioni, quindi fai clic su Forza disconnessione. A questo punto, l'emulatore si riavvia immediatamente e ti chiede di eseguire nuovamente l'accesso.
Navigazione
Dopo l'avvio, vedrai una tipica schermata Home di Android. Mouse sinistro i clic vengono tradotti direttamente in tocchi con le dita come nella modalità di emulazione del mouse. I giochi trasferiti tramite sideload per lo sviluppo vengono visualizzati nell'elenco delle applicazioni, che puoi facendo clic e trascinando verso l'alto sul desktop (emulando uno scorrimento verso l'alto uno smartphone o un tablet).
Oltre alla traduzione del mouse, l'emulatore per sviluppatori Google Play Giochi su PC offre Scorciatoie da tastiera per migliorare la navigazione:
Ctrl+H : premi il pulsante HomeCtrl+B : premi il pulsante IndietroF11 oAlt + Invio : consente di passare dalla modalità a schermo intero a quella a schermo intero e viceversa modalità a finestreMaiusc + Tab : apri l'overlay Google Play Giochi su PC, che include le mappature delle chiavi correnti per l'SDK di input
Installazione di un gioco
L'emulatore per gli sviluppatori di Google Play Giochi su PC utilizza Android Debug Bridge (adb) per installare pacchetti.
compatibilità ADB
Le versioni attuali di adb sono compatibili con l'emulatore per sviluppatori Google Play Giochi su PC.
Inoltre, al momento dell'installazione viene installata una versione compatibile all'indirizzo C:\Program
Files\Google\Play Games Developer Emulator\current\emulator
l'emulatore.
Per seguire queste istruzioni, adb deve essere disponibile nel tuo $PATH. Puoi
verifica che adb sia configurato correttamente con il comando adb devices
adb devices
List of devices attached
localhost:6520 device
Installa il gioco
- Avvia
Google Play Games for PC Emulator Digita
adb devicesnel prompt dei comandi. Dovresti vedere:adb devices List of devices attached localhost:6520 deviceRisoluzione dei problemi:
- Se visualizzi un messaggio di errore, verifica di aver seguito le istruzioni in Adb compatibilità.
- Se non vedi un dispositivo, prova a riconnetterti tramite la porta
6520:
adb connect localhost:6520Digita
adb install path\to\your\game.apkper installare il gioco. Se hai generato un Android App Bundle (aab), consulta le istruzioni bundletool e utilizza invecebundletool install-apks.Per gestire il gioco:
- Digita
adb shell monkey -p your.package.name 1per eseguire il gioco, sostituendoyour.package.namecon il nome del pacchetto del gioco. - Nell'emulatore per sviluppatori di Google Play Giochi su PC, fai clic sull'icona per eseguire il gioco. Proprio come su uno smartphone Android, devi scorrere verso l'alto in casa per vedere l'elenco dei giochi installati.
- Digita
Debug di un gioco
Utilizza Android Debug Bridge (adb) per eseguire il debug come per qualsiasi altro gioco.
L'emulatore viene visualizzato come un dispositivo connesso tramite localhost:6520.
adb logcat funziona come previsto, così come gli strumenti che aiutano a personalizzare o filtrare
Output logcat, incluso Android Studio.
Oltre che in adb, i log sono accessibili nella
Directory %LOCALAPPDATA%\Google\Play Games Developer Emulator\Logs. Più alta
utile qui è AndroidSerial.log, che rappresenta tutto adb logcat
dal momento dell'avvio dell'emulatore.
Impostazioni di sviluppo
L'emulatore per sviluppatori Google Play Giochi su PC è incentrato sull'efficienza degli sviluppatori piuttosto che sull'efficienza rispetto all'esperienza dell'utente finale. Ciò significa che hai accesso senza ostacoli Android, ad esempio l'utilizzo di Avvio app standard al posto del Google Play Giochi su PC e controlli sulle funzionalità disponibili altrimenti attivati e disattivati automaticamente per i giocatori.
Test dell'input del mouse in corso...
Per impostazione predefinita, durante lo sviluppo, l'emulatore per sviluppatori di Google Play Giochi su PC tocca anziché fornire un input diretto del mouse. Puoi attivare la funzionalità Direct del mouse di input facendo clic con il pulsante destro del mouse sull'icona della barra delle applicazioni e selezionando Opzioni sviluppatore, quindi Modalità PC (KiwiMouse).
Google Play Giochi su PC ha due modalità del mouse: una modalità emulata che traduce clic del mouse in singoli tocchi e in "modalità PC" passthrough che consente ai giochi di gestire le azioni del mouse in modo nativo ed eseguire l'acquisizione del puntatore. Per maggiori dettagli sull'input del mouse in Google Play Giochi su PC, consulta Configurare l'input del mouse.
Nel client del player, l'emulazione viene disattivata aggiungendo al file manifest:
<manifest ...>
<uses-feature
android:name="android.hardware.type.pc"
android:required="false" />
...
</manifest>
Questo flag di funzionalità non ha effetto nell'ambiente di sviluppo.
Test delle proporzioni in corso...
L'emulatore per sviluppatori viene lanciato con proporzioni 16:9, a differenza del player. che ricava le proporzioni dal display principale. A destra facendo clic sull'icona della barra delle applicazioni, selezionando Opzioni sviluppatore e poi nella sezione Rapporto di visualizzazione, puoi testare l'aspetto del gioco gli schermi dei vari giocatori.
Il metodo preferito per configurare le proporzioni
prevede l'utilizzo di android:minAspectRatio e android:maxAspectRatio.
Ad esempio:
un gioco verticale avrà proporzioni 9/16 o 0.5625, quindi ti consigliamo
imposta una proporzione massima di 1 per evitare che il gioco risulti più largo di quello quadrato:
<activity android:maxAspectRatio="1">
...
</activity>
Analogamente, un gioco orizzontale corrisponderà a 16/9 o circa 1.778, quindi ti consigliamo di
per impostare proporzioni minime di 1 in modo da evitare che diventi più magro del quadrato:
<activity android:minAspectRatio="1">
...
</activity>
Cosa verificare
Se il tuo gioco supporta solo le modalità verticali nel file manifest, puoi selezionare 9:16 (Ritratto) nel menu a discesa per vedere come appare sui giocatori PC. Altrimenti verificare che il gioco funzioni con i rapporti orizzontali più ampi e stretti che di assistenza nel tuo manifest, tenendo presente che 16:9 (valore predefinito) (o 9:16 (verticale) se il gioco è solo verticale) è obbligatoria per la certificazione completa.
Test dei backend di rendering
Google Play Giochi su PC utilizza ANGLE come livello di compatibilità per per verificare che le chiamate OpenGL ES vengano gestite correttamente dal PC host utilizzando un Backend OpenGL o Vulkan. L'emulatore supporta direttamente Vulkan, non su modalità video. Questo livello converte anche i formati di texture compressi solo per dispositivi mobili compatibili con PC. Facendo clic con il pulsante destro del mouse sull'icona della barra delle applicazioni e selezionando Override dello stack grafico, puoi impostarlo sul valore predefinito del sistema o forzare l'attivazione o la disattivazione di vulkan per i test di compatibilità.
Cosa verificare
Esistono delle variazioni minime nei formati di texture supportati e i passaggi necessari per che emula varie funzionalità mobile su computer. Durante la profilazione e l'ottimizzazione potrebbe valere la pena controllare ogni backend.
Profilazione del gioco per PC
Dato che l'emulatore utilizza la stessa tecnologia del client consumer, un ambiente adatto per la profilazione delle prestazioni.
Perfetto è uno strumento per analizzare le prestazioni su Android. Puoi raccogliere visualizza una traccia Perfetto seguendo questi passaggi:
In un prompt di PowerShell, avvia una traccia utilizzando
adbadb shell perfetto --time 10s gfx wm sched --out /data/misc/perfetto-traces/example.trace- Il flag
--timespecifica la durata della traccia da raccogliere.In questo Ad esempio, la traccia è di 10 secondi. - Gli argomenti dopo il flag
--timeindicano quali eventi devono essere tracciato. In questo esempiogfxindica grafici,wmgestione delle finestre e Informazioni sulla pianificazione del processosched. Questi sono flag comuni per la profilazione giochi e un riferimento completo è disponibile. - Il flag
--outspecifica il file di output, che viene estratto l'emulatore sulla macchina host nel passaggio successivo.
- Il flag
Esegui il pull della traccia dall'host
adb pull /data/misc/perfetto-traces/example.trace $HOME/Downloads/example.traceApri la traccia nella UI di Perfetto
- Apri ui.perfetto.dev.
- Seleziona Apri file di traccia nell'angolo in alto a sinistra sotto Navigazione.
- Apri il file
example.traceche hai scaricato nel passaggio precedente nella DirectoryDownloads/.
Controlla la traccia nella UI di Perfetto. Ecco alcuni suggerimenti:
- Ogni processo ha una propria riga, che può essere espansa per mostrare tutti i thread. in questo processo. Se stai eseguendo la profilazione di un gioco, è probabile che la relativa procedura sia la prima riga di comando.
- Puoi aumentare e diminuire lo zoom tenendo premuto Ctrl e usando la barra di scorrimento ruota.
- Quando utilizzi l'evento
sched, per ogni thread è presente una riga che mostra quando lo stato del thread è in esecuzione, eseguibile, in sospensione o bloccato. - Quando attivi un evento come
gfx, puoi vedere le varie chiamate grafiche effettuate da vari thread. Puoi selezionare singole "sezioni" a vedere quanto tempo ci hanno messo o trascinarle lungo una riga generando una "sezioni" sezione per aprirli in basso e mostrarti quanto tempo hanno impiegato tutte le sezioni finestra temporale selezionata.
Profilazione delle immagini
È possibile eseguire alcune profilazioni di grafica con RenderDoc.
- Impostare la variabile di ambiente
ANDROID_EMU_RENDERDOCin una stringa non vuota (ad esempio"1"). Imposta la variabile di ambiente
TMPsu%USERPROFILE%\AppData\LocalLow. Questo indica a Renderdoc di posizionare i file di log raggiungibile nella sandbox dell'emulatore.Se utilizzi il backend Vulkan. Seleziona Impostazioni grafica > Livelli impliciti dell'istanza Vulkan e assicurati che L'opzione VKLAYER_RENDERDOC_ Capture è selezionata.
Avvia l'emulatore per sviluppatori di Google Play Giochi su PC. Viene disegnato un overlay RenderDoc in alto, purché il supporto sia abilitato.
Avvia RenderDoc in qualsiasi momento prima o dopo l'emulatore per sviluppatori di Google Play Giochi su PC viene avviato.
Fai clic su File > Collega all'istanza in esecuzione e seleziona crosvm.
Specifica le variabili di ambiente
Affinché Renderdoc funzioni, devi aggiungere o modificare le variabili di ambiente in Windows. È possibile modificare le variabili di ambiente utilizzando l’interfaccia utente, PowerShell cmd.exe.
Utilizzo dell'interfaccia utente
- Premi
Win+R per aprire la finestra di dialogo Esegui. - Digita
sysdm.cplper aprire la finestra Proprietà del sistema. - Seleziona la scheda Avanzate se non è già attiva.
- Fai clic sul pulsante Variabili di ambiente.
Da qui puoi fare clic sul pulsante Nuovo per creare un nuovo ambiente oppure selezionane una e fai clic sul pulsante Modifica per modificarla.
Utilizza PowerShell
In una finestra PowerShell, digita:
$Env:VARIABLE_NAME=VALUE
Sostituisci VARIABLE_NAME e VALUE con i valori che vuoi impostare. Per
esempio, per impostare il tipo ANDROID_EMU_RENDERDOC su "1":
$Env:ANDROID_EMU_RENDERDOC="1"
Utilizzo di cmd.exe
In una finestra cmd.exe, digita:
set VARIABLE_NAME=VALUE
Sostituisci VARIABLE_NAME e VALUE con i valori che vuoi impostare. Per
esempio, per impostare il tipo ANDROID_EMU_RENDERDOC su "1":
set ANDROID_EMU_RENDERDOC="1"
Suggerimenti per Android 11 (livello API 30) o versioni successive
Google Play Giochi su PC è aggiornato con le ultime release di Android. Ecco alcuni suggerimenti per lavorare con la versione più recente di Android.
Mantieni gli strumenti aggiornati
Android Studio installa una versione di ADB compatibile con lo sviluppatore
emulatore; tuttavia, alcuni motori di gioco includono una versione precedente di adb. In questo
caso, dopo aver installato l'emulatore per sviluppatori, puoi trovare un modello
versione di adb all'indirizzo C:\Program Files\Google\Play Games Developer
Emulator\current\emulator.
Se avvii una versione di adb, termina l'altra. Ciò significa che
se il motore grafico avvia automaticamente la propria istanza adb, potresti avere
per riavviare e ricollegare la versione di adb fornita con lo sviluppatore
ogni volta che esegui il deployment.
Se usi un Android App Bundle, devi installare l'ultima versione di Bundletool dal repository GitHub.
Archiviazione con ambito
Android 11 (livello API 30) o versioni successive include l'archiviazione con ambito, che fornisce Migliore protezione dei dati delle app e degli utenti sullo spazio di archiviazione esterno. Oltre a rendere la tua di archiviazione con ambito compatibile con i requisiti di archiviazione con ambito, devi passaggi aggiuntivi per caricare i file di espansione APK (obb) o i dati degli asset nel Emulatore per sviluppatori Google Play Giochi su PC. Segui questi passaggi se riscontri problemi che accede a questi file dal tuo gioco:
- Crea una directory che possa essere letta dalla tua app.
- Esegui il push dei file di espansione nell'emulatore.
adb shell mkdir /sdcard/Android/obb/com.example.gameadb push main.com.example.game.obb /sdcard/Android/obb/com.example.game
Visibilità del pacchetto
A causa delle nuove regole per la visibilità dei pacchetti, le app destinate ad Android 11
(livello API 30) o versioni successive non possono eseguire query sulle informazioni sul
altre app installate su un dispositivo. Significa che il gioco è bloccato
di accedere a Play Services quando viene eseguito tramite sideload tramite adb anziché essere
installato tramite il Play Store. Per testare il tuo IAP con un gioco installato in sideload,
devi aggiungere una query al pacchetto "com.android.vending" nel tuo
AndroidManifest.xml come segue:
<manifest>
<queries>
<package android:name="com.android.vending" />
</queries>
</manifest>
Installazione del gioco nel client consumer
Non puoi installare un gioco sul client consumer finché non viene elencato nella Catalogo dei servizi per i giochi di Play. Dopo l'uscita di un singolo gioco, puoi creare un canale di test interno, convalidare gli aggiornamenti futuri prima del rilascio.
Il client del player non supporta le funzionalità incentrate sugli sviluppatori della Emulatore per sviluppatori Google Play Giochi su PC. È ideale per il QA del gioco prima del rilascio per testare l'esperienza end-to-end del player dopo la release iniziale.