Empaquetage des applications d’usure

Avertissement

Les documents et exemples de projets suivants peuvent ne plus être conservés. Depuis Xamarin.Android 11.1, l’empaquetage automatique d’une application Android Wear au sein d’une application portable Android n’est plus pris en charge. Il est recommandé de distribuer des applications Android Wear en tant qu’applications autonomes à la place.

Les applications Android Wear 1.0 sont empaquetées avec une application Android complète pour la distribution sur Google Play.

Les applications Android Wear 2.0 peuvent être soumises à Google Play en tant qu’applications autonomes.

Empaquetage automatique

À compter de Xamarin Android 5.0, votre application Wear est automatiquement empaquetée en tant que ressource dans votre application portable lorsque vous créez une référence de projet du projet Portable vers le projet Wear. Vous pouvez utiliser les étapes suivantes pour créer cette association :

Visual Studio

1. Si votre application Wear ne fait pas déjà partie de votre solution portable, cliquez avec le bouton droit sur le nœud de la solution, puis sélectionnez Ajouter un > projet existant....

2. Accédez au fichier .csproj de votre application Wear, sélectionnez-le, puis cliquez sur Ouvrir. Le projet d’application Wear doit maintenant être visible dans votre solution portable.

3. Cliquez avec le bouton droit sur le nœud Références , puis sélectionnez Ajouter une référence.

4. Dans la boîte de dialogue Gestionnaire de références, activez votre projet Wear (cliquez pour ajouter une coche), puis cliquez sur OK.

5. Modifiez le nom du package pour votre projet Wear afin qu’il corresponde au nom du package du projet Portable (le nom du package peut être modifié sous Propriétés > du manifeste Android).

Visual Studio pour Mac

1. Si votre application Wear ne fait pas déjà partie de votre solution portable, cliquez avec le bouton droit sur le nœud de la solution, puis sélectionnez Ajouter un > projet existant....

2. Accédez au fichier .csproj de votre application Wear, sélectionnez-le, puis cliquez sur Ouvrir. Le projet d’application Wear doit maintenant être visible dans votre solution portable.

3. Cliquez avec le bouton droit sur le nœud de projet Portable dans la solution, puis cliquez sur Modifier les références....

4. Dans la boîte de dialogue Modifier les références , activez votre projet Wear (cliquez pour ajouter une coche), puis cliquez sur OK.

5. Modifiez le nom du package pour votre projet Wear afin qu’il corresponde au nom du package du projet Portable (le nom du package peut être modifié sous Application Android Options > du projet).

Notez que vous obtiendrez une erreur XA5211 si le nom du package de l’application Wear ne correspond pas au nom du package de l’application portable. Par exemple :

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

Pour corriger cette erreur, modifiez le nom du package de l’application Wear afin qu’elle corresponde au nom du package de l’application portable.

Lorsque vous cliquez sur Générer > tout, cette association déclenche l’empaquetage automatique du projet Wear dans le projet Main Portable (Téléphone). L’application Wear est automatiquement générée et incluse en tant que ressource dans l’application portable.

L’assembly généré par le projet d’application Wear n’est pas utilisé comme référence d’assembly dans le projet Portable (Téléphone). Au lieu de cela, le processus de génération effectue les opérations suivantes :

• Vérifie que les noms de package correspondent.

• Génère du code XML et l’ajoute au projet Portable pour l’associer à l’application Wear. Par exemple :

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

• Ajoute l’application Wear en tant que ressource brute au projet Portable.

Empaquetage manuel

Vous pouvez écrire des applications Android Wear dans Xamarin.Android avant la version 5.0, mais vous devez suivre ces instructions d’empaquetage manuelles pour distribuer l’application :

1. Assurez-vous que vos projets Wearable et Portable (Téléphone) ont le même numéro de version et le même nom de package.

2. Générez manuellement le projet Wearable en tant que build Release .

3. Ajoutez manuellement la version . APK de l’étape (2) dans le répertoire Ressources/brut du projet Portable (Téléphone).

4. Ajoutez manuellement une nouvelle ressource XML Resources/xml/wearable_app_desc.xml dans le projet Portable qui fait référence à l’APK portable à partir de l’étape (3) :

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

5. Ajoutez manuellement un <meta-data /> élément à l’élément AndroidManifest.xml <application> du projet Portable qui fait référence à la nouvelle ressource XML :

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

Consultez également les instructions de packging manuel du site Android Developer.