Share via

封裝 Wear Apps

  • 發行項

警告

下列檔和範例專案可能不再維護。 自 Xamarin.Android 11.1 起，不再支援在 Android 手持應用程式中自動封裝 Android Wear 應用程式。 建議改為將 Android Wear 應用程式散發為 獨立應用程式 。

Android Wear 1.0 應用程式會與完整的 Android 應用程式一起封裝，以在 Google Play 上散發。

Android Wear 2.0 應用程式可以提交至 Google Play 作為 獨立應用程式。

自動封裝

從 Xamarin Android 5.0 開始，當您從 Handheld 專案建立項目參考到 Wear 專案時，您的 Wear 應用程式會自動封裝為手持應用程式中的資源。 您可以使用下列步驟來建立此關聯：

  1. 如果您的 Wear 應用程式還不是手持解決方案的一部分，請以滑鼠右鍵按兩下方案節點，然後選取[ 新增 > 現有專案...]。

  2. 流覽至 Wear 應用程式的 .csproj 檔案，選取它，然後按兩下 [ 開啟]。 Wear 應用程式項目現在應該會顯示在您的手持解決方案中。

  3. 以滑鼠右鍵按兩下 [ 參考] 節點，然後選取 [ 新增參考]。

  4. 在 [ 參考管理員] 對話框中，啟用您的 Wear 專案（按兩下以新增複選標記），然後按兩下 [ 確定]。

  5. 變更 Wear 專案的套件名稱，使其符合 Handheld 專案的套件名稱（套件名稱可以在 [屬性 > Android 指令清單] 底下變更）。

請注意，如果 Wear 應用程式的套件名稱不符合手持應用程式的套件名稱，您會收到 XA5211 錯誤。 例如：

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

若要更正此錯誤，請變更 Wear 應用程式的套件名稱，使其符合手持應用程式的套件名稱。

當您按兩下 [建置全部建>置] 時，此關聯會觸發 Wear 專案的自動封裝到主要手持 （電話） 專案。 Wear 應用程式會自動建置並包含在手持應用程式中作為資源。

Wear 應用程式項目產生的元件不會當做在 Handheld （電話） 專案中的元件參考使用。 相反地，建置程式會執行下列動作：

  • 驗證套件名稱是否相符。

  • 產生 XML，並將其新增至 Handheld 專案，使其與 Wear 應用程式產生關聯。 例如：

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

  • 將 Wear 應用程式新增為 原始 資源至 Handheld 專案。

手動封裝

您可以在 5.0 版之前在 Xamarin.Android 中撰寫 Android Wear 應用程式，但您必須遵循下列手動封裝指示來散發應用程式：

  1. 請確定您的可穿戴專案和手持裝置 （電話） 專案具有相同的版本號碼和套件名稱。

  2. 手動建置可穿戴專案作為 發行 組建。

  3. 手動新增發行 。APK 從步驟 （2） 進入手持 （電話） 專案的 Resources/raw 目錄。

  4. 在手持專案中手動新增 XML 資源資源 /xml/wearable_app_desc.xml ，其參照步驟中的可穿戴 APK （3）：

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

  5. 手動將元素新增 <meta-data /> 至 Handheld 專案的 AndroidManifest.xml<application> 專案，該元素會參考新的 XML 資源：

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

另請參閱 Android 開發人員網站的 手動封裝指示。