Guida rapida

Configura l'estensione Android Game Development su un computer Windows ed esegui un progetto Visual Studio C++ di esempio su un emulatore o un dispositivo Android.

Prerequisiti

Segui i passaggi in questa sezione per preparare il tuo computer Windows all'installazione dell'estensione:

  1. Scarica e installa una delle versioni supportate di Visual Studio:

  2. Scarica e installa l'SDK .NET Core 2.2.

  3. Android Studio 3.5 o versioni successive è facoltativo, ma può essere utilizzato al posto dell'estensione Android Game Development per installare l'SDK Android e NDK.

  4. Scarica e installa JDK 17 per AGDE 23.1.82 o versioni successive oppure JDK 11 per un massimo di AGDE 22.2.71 e imposta la variabile di ambiente JAVA_HOME.

Installa l'estensione

Segui i passaggi in questa sezione per scaricare e installare l'estensione Android Game Development:

  1. Chiudi tutte le istanze di Visual Studio.

  2. Scarica il programma di installazione delle estensioni più recente e gli esempi dalla pagina Download.

  3. Dal percorso di download, fai doppio clic sul programma di installazione. L'installazione richiede diversi minuti.

  4. Se hai installato più di una versione di Visual Studio, seleziona quelle per cui vuoi installare l'estensione.

  5. Fai clic su Fine per completare l'installazione.

Installa l'SDK Android e NDK

Puoi installare l'SDK Android e il native Development Kit (NDK) per Android utilizzando Android Studio o l'estensione Android Game Development. Per installare l'SDK e NDK dall'estensione, utilizza SDK Manager, che si trova nella barra degli strumenti delle estensioni di Visual Studio.

Quando installi l'NDK, assicurati di utilizzare la casella di controllo NDK (affiancata) in modo che l'estensione possa individuarla. Devi installare una versione NDK supportata dall'estensione (vedi cronologia delle revisioni NDK).

Per installare l'SDK in una posizione diversa da quella predefinita, imposta la variabile di ambiente ANDROID_SDK_ROOT sul tuo computer:

  1. Assicurati che Visual Studio sia chiuso.
  2. In Windows Search, cerca Environment Variables.
  3. Seleziona Modifica le variabili di ambiente di sistema.
  4. Fai clic su Variabili di ambiente.
  5. In Variabili utente, fai clic su Nuova.
  6. Nella casella Nome variabile, digita ANDROID_SDK_ROOT.
  7. Nella casella Valore variabile, inserisci il percorso all'SDK Android.
  8. Riavvia il computer.

La posizione dell'SDK non può essere modificata utilizzando la finestra di SDK Manager poiché questa variabile di ambiente è l'unica fonte attendibile per la posizione dell'SDK.

Esegui l'esempio

Segui i passaggi in questa sezione per eseguire un esempio fornito su un emulatore e poi su un dispositivo Android fisico.

Configura la piattaforma

  1. Decomprimi il file ZIP di esempio in una directory a tua scelta. Sono inclusi i seguenti esempi:

  2. Avvia Visual Studio se non è già in esecuzione.

  3. Apri la directory degli esempi. Seleziona File > Apri > Progetto/Soluzione e vai al file .sln.

  4. Seleziona una piattaforma Android:

    1. Seleziona Build > Configuration Manager.
    2. In Piattaforma della soluzione attiva, seleziona Android-x86_64.

    Le piattaforme Android sono già configurate negli esempi (consulta la pagina relativa all'aggiunta di altre piattaforme Android per l'aggiunta di piattaforme).

  5. Assicurati che nel progetto di esempio siano configurate le proprietà dell'SDK Android e NDK:

    Figura 1. Proprietà della piattaforma Android

    • In Esplora soluzioni, fai clic con il tasto destro del mouse sul progetto e seleziona Proprietà.

    • Seleziona la scheda Proprietà generali e trova le proprietà Piattaforma per Android.

  6. Seleziona la scheda delle proprietà Android Packaging.

    Figura 2. Proprietà di pacchettizzazione di Android

    Puoi modificare la directory e il nome dell'APK di output da questa scheda. Tieni presente che alcune proprietà di configurazione di Android sono definite nelle pagine delle proprietà e vengono trasmesse a Gradle. Ad esempio, la proprietà del nome dell'APK MSBUILD_ANDROID_OUTPUT_APK_NAME passa questo nome al file dell'app build.gradle.

Configura l'emulatore

  1. Avvia AVD Manager dalla barra degli strumenti delle estensioni in Visual Studio. Configura un dispositivo virtuale ed eseguilo nell'emulatore Android.

    1. In Gestione dispositivi virtuali Android, fai clic su Crea dispositivo virtuale.
    2. Scegli una definizione del dispositivo (ad esempio, Pixel 2).
    3. Seleziona un'immagine di sistema. Devi selezionare un'ABI x86_64 perché questa architettura si comporta più velocemente nell'emulatore.
    4. Verifica la configurazione e fai clic su Fine.

  2. Avvia il dispositivo virtuale facendo clic sul pulsante Esegui Icona Esegui in Gestione dispositivi virtuali Android.

  3. In Visual Studio, il dispositivo virtuale dovrebbe apparire accanto al pulsante della barra degli strumenti Avvia debug. Fai clic su Avvia debug per avviare l'app di esempio sul dispositivo. Potrebbero essere necessari alcuni istanti per collegare il debugger all'app. Se esegui l'esempio di Teapot, puoi ruotare la teiera trascinando sopra il cursore del mouse.

    Esempio di Teapot in esecuzione su un emulatore
    Figura 3. Esempio di teapot in esecuzione su un emulatore Android

Configura il dispositivo

  1. Per eseguire l'esempio su un dispositivo Android fisico, potrebbe essere necessario creare una nuova piattaforma Android nel progetto. Questa piattaforma deve corrispondere all'architettura del dispositivo. Per creare una nuova piattaforma, segui questi passaggi in Visual Studio:

    1. Seleziona Build > Configuration Manager.
    2. In Piattaforma soluzione attiva, seleziona <Nuova>.

    3. Digita uno dei seguenti valori per la nuova piattaforma:

      • Android-armeabi-v7a
      • Android-arm64-v8a
      • Android x86
      • Android-x86_64

    4. Nella casella Copia impostazioni da, seleziona un'altra piattaforma Android (o Nessuna se non hai ancora piattaforme Android). Assicurati di aver attivato l'opzione Crea nuove piattaforme di progetto.

  2. Collega un dispositivo Android al computer tramite un cavo USB. Il tipo di dispositivo dovrebbe essere mostrato accanto al pulsante della barra degli strumenti Avvia debug.

    Pulsante Esegui in Visual Studio
    Figura 4. Dispositivo Android connesso mostrato accanto al pulsante Avvia debug della barra degli strumenti

    Se il dispositivo non viene mostrato, controlla quanto segue:

    • La piattaforma selezionata corrisponde all'ABI del tuo dispositivo.
    • Le Opzioni sviluppatore e il debug USB sono attivati sul dispositivo.
    • Il cavo USB sia collegato dal dispositivo al computer.
    • Il cavo USB supporta una connessione dati (e non solo l'alimentazione).

  3. Fai clic sul pulsante della barra degli strumenti Avvia debug per avviare l'app di esempio sul dispositivo. Potrebbero essere necessari alcuni minuti prima che il debugger si colleghi all'app. Una volta collegato, puoi interagire con l'app sul tuo dispositivo.

Domande frequenti

Di seguito sono riportate alcune domande frequenti sull'estensione Android Game Development.

Dove si trovano i log del plug-in?

Puoi aprire il file di log del plug-in utilizzando l'icona Open Logs (Apri log) nella barra degli strumenti dell'Android Game Development Extension.

Quali variabili di ambiente utilizza il plug-in?

Il plug-in utilizza le seguenti variabili di ambiente:

  • ANDROID_SDK_ROOT
  • ANDROID_SDK_HOME
  • TEMP
  • GOOGLE_ANDROID_LOG_DIR

Passaggio successivo

Per utilizzare il tuo progetto con l'estensione, devi configurarla in base alla guida alla configurazione del progetto.