Set Up Device for Development (Configurare il dispositivo per lo sviluppo)Set Up Device for Development

Questo articolo illustra come installare un dispositivo Android e connetterlo a un computer in modo che il dispositivo possa essere usato per eseguire applicazioni Xamarin.Android ed eseguirne il debug.This article explains how to setup an Android device and connect it to a computer so that the device may be used to run and debug Xamarin.Android applications.

Al termine dei test in un emulatore Android, sarà utile visualizzare e testare le app in esecuzione in un dispositivo Android.After testing on an Android emulator, you will want to see and test your apps running on an Android device. Ecco i passaggi richiesti per la connessione di un dispositivo a un computer per il debug:Here are the steps involved with connecting a device to a computer for debugging:

  1. Abilitare il debug nel dispositivo - Per impostazione predefinita, non sarà possibile eseguire il debug di applicazioni in un dispositivo Android.Enable Debugging on the Device - By default, it will not be possible to debug applications on a Android device.

  2. Installare i driver USB - Questo passaggio non è necessario per i computer macOS.Install USB Drivers - This step is not necessary for macOS computers. Per computer Windows può essere richiesta l'installazione di driver USB.Windows computers may require the installation of USB drivers.

  3. Connettere il dispositivo al computer - Il passaggio finale prevede la connessione del dispositivo al computer tramite USB o Wi-Fi.Connect the Device to the Computer - The final step involves connecting the device to the computer by either USB or WiFi.

Ognuno di questi passaggi verrà descritto più dettagliatamente nelle sezioni seguenti.Each of these steps will be covered in more detail in the sections below.

Abilitare il debug nel dispositivoEnable Debugging on the Device

È possibile usare qualsiasi dispositivo Android per testare un'applicazione Android.It is possible to use any Android device to test an Android application. Tuttavia, il dispositivo deve essere configurato correttamente prima di poter eseguire il debug.However the device must be properly configured before debugging can occur. La procedura è leggermente diversa a seconda della versione di Android in esecuzione nel dispositivo.The steps involved are slightly different, depending on the version of Android running on the device.

Da Android 4.0 a Android 4.1Android 4.0 to Android 4.1

Per le versioni da Android 4.0.x ad Android 4.1.x, è possibile abilitare il debug seguendo questa procedura:For Android 4.0.x to Android 4.1.x, debugging is enabled by following these steps:

  1. Passare alla schermata Impostazioni.Go to the Settings screen.
  2. Selezionare Opzioni sviluppatore.Select Developer options .
  3. Deselezionare l'opzione Debug USB.Check off the USB debugging option.

Questo screenshot mostra la schermata Opzioni sviluppatore in un dispositivo che esegue Android 4.0.3:This screenshot shows the Developer options screen on a device running Android 4.0.3:

Opzioni sviluppatoreDeveloper options

Android 4.2 e versioni successiveAndroid 4.2 and higher

A partire da Android 4.2 e versioni successive, l'impostazione Opzioni sviluppatore è nascosta per impostazione predefinita.Starting in Android 4.2 and higher, the Developer options is hidden by default. Per renderla disponibile, passare a Impostazioni > Info sul telefono e toccare l'elemento Numero build sette volte per visualizzare la scheda Opzioni sviluppatore:To make it available, go to Settings > About phone, and tap the Build number item seven times to reveal the Developer Options tab:

Elemento Numero buildBuild number item

Quando la scheda Opzioni sviluppatore è disponibile in Impostazioni > Sistema, aprirla per visualizzare le impostazioni per sviluppatori:Once the Developer Options tab is available under Settings > System, open it to reveal developer settings:

Schermata Opzioni sviluppatoreDeveloper settings screen

Questa è la posizione in cui è possibile abilitare le opzioni per sviluppatori, ad esempio il debug USB e la modalità Rimani attivo.This is the place to enable developer options such as USB debugging and stay awake mode.

Installare i driver USBInstall USB Drivers

Questo passaggio non è necessario per macOS, perché è sufficiente connettere il dispositivo al Mac con un cavo USB.This step is not necessary for macOS, just connect the device to the Mac with a USB cable.

Potrebbe essere necessario installare alcuni driver aggiuntivi prima che un computer Windows riconosca un dispositivo Android connesso tramite USB.It may be necessary to install some extra drivers before a Windows computer will recognize an Android device connected by USB.

Nota

Questa è la procedura per configurare un dispositivo Google Nexus ed è disponibile per riferimento.These are the steps to set up a Google Nexus device and are provided as a reference. La procedura per il dispositivo specifico in uso potrebbe essere leggermente diversa, anche se a grandi linee simile.Steps for your specific device may vary, but will follow a similar pattern. Cercare informazioni sul dispositivo specifico in Internet in caso di problemi.Search the internet for your device if you have trouble.

Eseguire l'applicazione android.bat nella directory [Percorso installazione Android SDK]\tools.Run the android.bat application in the [Android SDK install path]\tools directory. Per impostazione predefinita, il programma di installazione di Xamarin.Android posiziona Android SDK nel percorso seguente in un computer Windows:By default, the Xamarin.Android installer will put the Android SDK in following location on a Windows computer:

C:\Users\[username]\AppData\Local\Android\android-sdk

Scaricare i driver USBDownload the USB Drivers

I dispositivi Google Nexus (fatta eccezione per Galaxy Nexus) richiedono il driver USB Google.Google Nexus devices (with the exception of the Galaxy Nexus) require the Google USB Driver. Il driver per i dispositivi Galaxy Nexus viene distribuito da Samsung.The driver for the Galaxy Nexus is distributed by Samsung. Tutti gli altri dispositivi Android devono usare il driver USB fornito dal produttore.All other Android devices should use the USB driver from their respective manufacturer.

Per installare il pacchetto Google USB Driver avviare Android SDK Manager ed espandere la cartella Extras, come nello screenshot seguente:Install the Google USB Driver package by starting the Android SDK Manager, and expanding the Extras folder, as can be seen in the follow screenshot:

Pacchetto Google USB Driver selezionatoGoogle USB Driver Package selected

Selezionare la casella Google USB Driver e fare clic sul pulsante Install (Installa).Check the Google USB Driver box, and click the Install button. I file del driver vengono scaricati nel percorso seguente:The driver files are downloaded to the following location:

[Android SDK install path]\extras\google\usb\_driver

Il percorso predefinito per un'installazione di Xamarin.Android è:The default path for a Xamarin.Android installation is:

C:\Users\[username]\AppData\Local\Android\android-sdk\extras\google\usb_driver

Installazione del driver USBInstalling the USB Driver

Dopo aver scaricato i driver USB, è necessario installarli.After the USB drivers are downloaded, it is necessary to install them. Per installare i driver in Windows 7:To install the drivers on Windows 7:

  1. Connettere il dispositivo al computer con un cavo USB.Connect your device to the computer with a USB cable.

  2. Fare clic con il pulsante destro del mouse sul computer nel desktop o in Esplora risorse e scegliere Gestisci.Right-click on the Computer from your desktop or Windows Explorer, and select Manage .

  3. Selezionare Dispositivi nel riquadro a sinistra.Select Devices in the left pane.

  4. Individuare ed espandere Altri dispositivi nel riquadro a destra.Locate and expand Other Devices in the right pane.

  5. Fare clic con il pulsante destro del mouse sul nome del dispositivo e scegliere Aggiornamento software driver.Right-click the device name and select Update Driver Software . Verrà avviato l'Aggiornamento guidato hardware.This will launch the Hardware Update Wizard.

  6. Selezionare Cerca il software del driver nel computer e fare clic su Avanti.Select Browse my computer for driver software and click Next .

  7. Fare clic su Sfoglia e individuare la cartella del driver USB (il driver USB Google si trova in [Percorso installazione Android SDK]\extras\google\usb_driver).Click Browse and locate the USB driver folder (the Google USB driver is located in [Android SDK install path]\extras\google\usb_driver).

  8. Fare clic su Avanti per installare il driver.Click Next to install the driver.

Installazione di driver non verificati in Windows 8Installing Unverified Drivers in Windows 8

Potrebbero essere necessari alcuni passaggi aggiuntivi per installare un driver non verificato in Windows 8.Extra steps may be required to install an unverified driver in Windows 8. La procedura seguente descrive come installare i driver per un dispositivo Galaxy Nexus:The following steps describe how to install the drivers for a Galaxy Nexus:

  1. Accedere alle opzioni di avvio avanzate di Windows 8: per questo passaggio è necessario riavviare il computer per accedere alle opzioni di avvio avanzate.Access the Windows 8 Advanced Boot Options - This step involves rebooting the computer to access the Advanced Boot Options. Avviare un prompt dei comandi e riavviare il computer con il comando seguente:Start up a command line prompt and reboot the computer by using the following command:

    shutdown.exe /r /o
    
  2. Connettere il dispositivo: connettere il dispositivo al computerConnect the device - Connect the device to the computer

  3. Avviare Gestione dispositivi: eseguire devmgmt.msc. Il dispositivo dovrebbe essere elencato con un triangolo giallo su di esso.Start Device Manager - Run devmgmt.msc; you should see your device listed with a yellow triangle over it.

  4. Installare i driver di dispositivo: installare i driver di dispositivo, come descritto in precedenza.Install the Device Drivers - Install the device drivers as described above.

Connettere il dispositivo al computerConnect the Device to the Computer

Il passaggio finale prevede la connessione del dispositivo al computer.The final step is to connect the device to the computer. È possibile procedere in due modi:There are two ways to do so:

  • Cavo USB: questo è il modo più semplice e più comune.USB cable - This is the easiest and most common way. Collegare semplicemente il cavo USB nel dispositivo e quindi nel computer.Just plug the USB cable into the device and then into the computer.

  • Wi-Fi: è possibile connettere un dispositivo Android a un computer senza usare un cavo USB, tramite Wi-Fi.WiFi - It is possible to connect an Android device to a computer without using a USB cable, over WiFi. Questa tecnica è un po' più complessa, ma potrebbe essere utile quando il dispositivo è troppo lontano dal computer per essere costantemente collegato tramite cavo.This technique requires a bit more effort but could be useful when the device is too far from the computer to remain constantly plugged-in via cable. La connessione tramite Wi-Fi verrà descritta nella sezione successiva.Connecting via WiFi will be covered in the next section.

Connessione tramite Wi-FiConnecting over WiFi

Per impostazione predefinita, Android Debug Bridge (ADB) è configurato per comunicare con un dispositivo Android tramite USB.By default, the Android Debug Bridge (ADB) is configured to communicate with an Android device via USB. È possibile riconfigurarlo per l'uso di TCP/IP anziché USB.It is possible to reconfigure it to use TCP/IP instead of USB. A tale scopo, sia il dispositivo che il computer devono trovarsi nella stessa rete Wi-Fi.To do this, both the device and the computer must be on the same WiFi network. Per configurare l'ambiente per eseguire il debug tramite Wi-Fi, eseguire questi passaggi dalla riga di comando:To setup your environment to debug over WiFi issue these steps from the command line:

  1. Determinare l'indirizzo IP del dispositivo Android.Determine the IP address of your Android device. Un modo per individuare l'indirizzo IP è controllare in Impostazioni > Wi-Fi e quindi toccare la rete Wi-Fi a cui è connesso il dispositivo.One way to find out the IP address is to look under Settings > Wi-Fi , and then tap on the WiFi network that the device is connected to. Verrà visualizzata una schermata di impostazioni che mostra informazioni sulla connessione di rete, simile allo screenshot seguente:This will bring up a settings screen showing information about the network connection, similar to what is seen in the screenshot below:

    Indirizzo IP

    In alcune versioni di Android l'indirizzo IP non viene elencato, ma è disponibile in Impostazioni > Info sul telefono > Stato.On some versions of Android the IP address won't be listed there but can be found instead under Settings > About phone > Status.

  2. Connettere il dispositivo Android al computer tramite USB.Connect your Android device to your computer via USB.

  3. Riavviare quindi ADB in modo che usi TCP sulla porta 5555.Next, restart ADB so that it using TCP on port 5555. Digitare il comando seguente da un prompt dei comandi:From a command prompt, type the following command:

    adb tcpip 5555
    

    Dopo aver eseguito questo comando, il computer non potrà essere in ascolto dei dispositivi connessi tramite USB.After this command is issued, your computer will not be able to listen to devices that are connected via USB.

  4. Scollegare il cavo USB che connette il dispositivo al computer.Disconnect the USB cable connecting your device to your computer.

  5. Configurare ADB in modo che si connetta al dispositivo Android sulla porta specificata nel passaggio 1:Configure ADB so that it will connect to your Android device on the port that was specified in step 1 above:

    adb connect 192.168.1.28:5555
    

    Dopo l'esecuzione di questo comando, il dispositivo Android è connesso al computer tramite Wi-Fi.Once this command finished the Android device is connected to the computer via WiFi.

Al termine delle operazioni di debug tramite Wi-Fi, è possibile reimpostare la modalità USB per ADB con il comando seguente:When you're done debugging via WiFi, it is possible reset ADB back to USB mode with the following command:

adb usb

È possibile chiedere ad ADB di elencare i dispositivi connessi al computer.It is possible to ask ADB to list the devices that are connected to the computer. Indipendentemente dalla modalità di connessione dei dispositivi, è possibile eseguire il comando seguente al prompt dei comandi per visualizzare i dispositivi connessi:Regardless of how the devices are connected, you can issue the following command at the command prompt to see what is connected:

adb devices

RiepilogoSummary

In questo articolo sono state illustrate le procedure per configurare un dispositivo Android per lo sviluppo abilitando il debug nel dispositivo.This article discussed how to configure an Android device for development by enabling debugging on the device. È stato anche descritto come connettere il dispositivo a un computer tramite USB o Wi-Fi.It also covered how to connect the device to a computer using either USB or WiFi.