Packaging Wear Apps

Avviso

I documenti e i progetti di esempio seguenti potrebbero non essere più mantenuti. A partire da Xamarin.Android 11.1, la creazione automatica di un pacchetto di un'applicazione Android Wear in un'applicazione palmare Android non è più supportata. È consigliabile distribuire le applicazioni Android Wear come applicazioni autonome.

Le app Android Wear 1.0 sono in pacchetto con un'app Android completa per la distribuzione su Google Play.

Le app Android Wear 2.0 possono essere inviate a Google Play come applicazioni autonome.

Creazione automatica dei pacchetti

A partire da Xamarin Android 5.0, l'app Wear viene inserita automaticamente come risorsa nell'app Palmare quando si crea un riferimento al progetto Palmare al progetto Wear. Per creare questa associazione, è possibile seguire questa procedura:

Visual Studio

1. Se l'app Wear non fa già parte della soluzione Palmare, fare clic con il pulsante destro del mouse sul nodo della soluzione e scegliere Aggiungi > progetto esistente....

2. Passare al file con estensione csproj dell'app Wear, selezionarlo e fare clic su Apri. Il progetto di app Wear dovrebbe ora essere visibile nella soluzione Palmare.

3. Fare clic con il pulsante destro del mouse sul nodo Riferimenti e scegliere Aggiungi riferimento.

4. Nella finestra di dialogo Gestione riferimenti abilitare il progetto Wear (fare clic per aggiungere un segno di spunta), quindi fare clic su OK.

5. Modificare il nome del pacchetto per il progetto Wear in modo che corrisponda al nome del pacchetto del progetto Palmare (il nome del pacchetto può essere modificato in Proprietà > manifesto Android).

Visual Studio per Mac

1. Se l'app Wear non fa già parte della soluzione Palmare, fare clic con il pulsante destro del mouse sul nodo della soluzione e scegliere Aggiungi > progetto esistente....

2. Passare al file con estensione csproj dell'app Wear, selezionarlo e fare clic su Apri. Il progetto di app Wear dovrebbe ora essere visibile nella soluzione Palmare.

3. Fare clic con il pulsante destro del mouse sul nodo del progetto Palmare nella soluzione e scegliere Modifica riferimenti.

4. Nella finestra di dialogo Modifica riferimenti abilitare il progetto Wear (fare clic per aggiungere un segno di spunta), quindi fare clic su OK.

5. Modificare il nome del pacchetto per il progetto Wear in modo che corrisponda al nome del pacchetto del progetto Palmare (il nome del pacchetto può essere modificato in Project Options > Android Application).

Tieni presente che riceverai un errore XA5211 se il nome del pacchetto dell'app Wear non corrisponde al nome del pacchetto dell'app Palmare. Ad esempio:

Error XA5211: Embedded wear app package name differs from handheld 
app package name (com.companyname.mywearapp != com.companyname.myapp). (XA5211)

Per correggere questo errore, modificare il nome del pacchetto dell'app Wear in modo che corrisponda al nome del pacchetto dell'app Palmare.

Quando si fa clic su Compila > tutto, questa associazione attiva la creazione automatica del pacchetto del progetto Wear nel progetto principale Palmare (Telefono). L'app Wear viene compilata automaticamente e inclusa come risorsa nell'app Palmare.

L'assembly generato dal progetto di app Wear non viene usato come riferimento all'assembly nel progetto Palmare (Phone). Il processo di compilazione esegue invece le operazioni seguenti:

• Verifica che i nomi dei pacchetti corrispondano.

• Genera codice XML e lo aggiunge al progetto Palmare per associarlo all'app Wear. Ad esempio:

  <!-- Handheld (Phone) Project.csproj -->
  <ProjectReference Include="..\MyWearApp\MyWearApp.csproj">
      <Project>{D80E1FEF-653B-448C-B2AA-609C74E88340}</Project>
      <Name>MyWearApp</Name>
      <IsAppExtension>True</IsAppExtension>
  </ProjectReference>
  

• Aggiunge l'app Wear come risorsa non elaborata al progetto Palmare.

Creazione manuale dei pacchetti

È possibile scrivere app Android Wear in Xamarin.Android prima della versione 5.0, ma è necessario seguire queste istruzioni manuali per la creazione di pacchetti per distribuire l'app:

1. Assicurarsi che il progetto Indossabile e i progetti Palmari (Telefono) abbiano lo stesso numero di versione e il nome del pacchetto.

2. Compilare manualmente il progetto Indossabile come build di rilascio .

3. Aggiungere manualmente la versione . APK del passaggio (2) nella directory Resources/raw del progetto Palmare (Phone).

4. Aggiungere manualmente una nuova risorsa XML Resources/xml/wearable_app_desc.xml nel progetto Palmare che fa riferimento all'APK indossabile nel passaggio (3):

   <wearableApp package="wearable.app.package.name">
       <versionCode>1</versionCode>
       <versionName>1.0</versionName>
       <rawPathResId>NAME_OF_APK_FROM_STEP_3</rawPathResId>
   </wearableApp>
   

5. Aggiungere manualmente un <meta-data /> elemento all'elemento AndroidManifest.xml <application> del progetto Palmare che fa riferimento alla nuova risorsa XML:

   <meta-data android:name="com.google.android.wearable.beta.app"
       android:resource="@xml/wearable_app_desc"/>
   

Vedere anche le istruzioni di creazione manuale del pacchetto del sito per sviluppatori Android.