Guida rapida

Configura l'estensione per lo sviluppo di giochi per Android su un computer Windows ed esegui un progetto di esempio Visual Studio C++ su un dispositivo o emulatore Android.

Prerequisiti

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

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

  2. Scarica e installa .NET Core SDK 2.2.

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

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

Installare l'estensione

Segui i passaggi descritti in questa sezione per scaricare e installare l'estensione per lo sviluppo di giochi per Android:

  1. Chiudi tutte le istanze di Visual Studio.

  2. Scarica l'ultima versione del programma di installazione dell'estensione e degli esempi dalla pagina Download.

  3. Dalla posizione di download, fai doppio clic sul programma di installazione. Il completamento del programma di installazione richiede diversi minuti.

  4. Se hai installato più versioni 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) con Android Studio o l'estensione per lo sviluppo di giochi per Android. Per installare l'SDK e l'NDK dall'estensione, utilizza SDK Manager, che si trova nella barra degli strumenti dell'estensione di Visual Studio.

Quando installi l'NDK, assicurati di utilizzare la casella di controllo NDK (affiancato) in modo che l'estensione possa individuarlo. Devi installare una versione dell'NDK supportata dall'estensione (vedi la cronologia delle revisioni dell'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. Nella sezione Variabili utente, fai clic su Nuova.
  6. Nella casella Nome variabile, digita ANDROID_SDK_ROOT.
  7. Nella casella Valore variabile, inserisci il percorso dell'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 di verità per la posizione dell'SDK.

Esegui il campione

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

Configurare la piattaforma

  1. Decomprimi il file zip degli esempi in una directory a tua scelta. Sono inclusi i seguenti campioni:

    • endless-tunnel
    • HelloJNI
    • Teiera

  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 (Build > Configuration Manager).
    2. In Active solution platform (Piattaforma della soluzione attiva), seleziona Android-x86_64.

    Le piattaforme Android sono già configurate negli esempi (vedi aggiungere altre piattaforme Android per l'aggiunta di piattaforme).

  5. Assicurati che nel progetto di esempio siano configurate le proprietà dell'SDK Android e dell'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 delle proprietà Generali e trova le proprietà Piattaforma per Android.

  6. Seleziona la scheda delle proprietà Android Packaging.

    Figura 2. Proprietà di packaging Android

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

Configurare l'emulatore

  1. Avvia AVD Manager dalla barra degli strumenti delle estensioni in Visual Studio. Configura un dispositivo virtuale e poi esegui il test nell'emulatore Android.

    1. In Android Virtual Device Manager, 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 funziona più velocemente nell'emulatore.
    4. Verifica la configurazione e fai clic su Fine.

  2. Avvia il dispositivo virtuale facendo clic sul pulsante Esegui Icona Run in Android Virtual Device Manager.

  3. In Visual Studio, il dispositivo virtuale dovrebbe essere visualizzato 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 prima che il debugger venga collegato all'app. Se esegui l'esempio Teapot, puoi ruotare la teiera trascinando il cursore del mouse.

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

Configurare 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 (Build > Configuration Manager).
    2. In Piattaforma di soluzioni attiva, seleziona <Nuovo>.

    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 esistente (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 utilizzando un cavo USB. Il tipo di dispositivo dovrebbe essere visualizzato accanto al pulsante della barra degli strumenti Avvia debug.

    Pulsante Esegui in Visual Studio
    Figura 4. Il dispositivo Android connesso viene visualizzato accanto al pulsante della barra degli strumenti Avvia debug

    Se il dispositivo non viene visualizzato, controlla quanto segue:

    • La selezione della piattaforma corrisponde all'ABI del tuo dispositivo.
    • Opzioni sviluppatore e debug USB sono attivi sul dispositivo.
    • Il cavo USB è 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 occorrere alcuni istanti prima che il debugger venga collegato all'app. Una volta collegato, puoi interagire con l'app sul tuo dispositivo.

Domande frequenti

Di seguito sono riportate alcune domande frequenti sull'estensione per lo sviluppo di giochi per Android.

Dove si trovano i log del plug-in?

Puoi aprire il file di log del plug-in utilizzando l'icona Apri log nella barra degli strumenti 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

Passaggi successivi

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