從 Vuforia 到 Unity 打包全攻略 讓你的 AR 專案順利上線！

https://www.youtube.com/watch?v=cwgYMdYdK3A

想把自己用 Vuforia 製作的 Unity AR 專案部署到手機上嗎？完成 AR 內容只是第一步，如何順利打包並部署到 Android 或 iOS 裝置，才是讓專案真正上線的關鍵。本篇文章將帶你一步步完成從專案設定到實機打包的流程，讓你的 AR 應用能順利運行在手機上，無論是 Android APK 或 AAB，還是 iOS 的 Xcode 專案，都能輕鬆搞定。

!俯視角度展示 Unity 編輯器中 Vuforia 設定畫面

Unity 編輯器中 Vuforia 設定畫面，準備進行專案打包

Vuforia 專案打包前的基本設定

在開始打包之前，必須先確認 Vuforia 專案的設定完整且正確。這包括：

• License Key Vuforia基本的Camera權限

確認你已在 Vuforia Developer Portal 申請並取得 License Key，並且已經在 Unity 的 Vuforia Configuration 中填入。

• Target Device 設定 (Android 10/11以上)

根據你的目標平台（Android 或 iOS），選擇合適的目標裝置設定。Vuforia 支援多種裝置，但不同平台有不同的限制與需求。

• 相機權限與設定 (上架需要的文件)

AR 專案需要使用相機，請在 Unity 中確認相機權限已設定，並且在 AndroidManifest.xml 或 iOS Info.plist 中加入相機使用說明。

• 圖像辨識資料庫 (雲端或者是在本地端的圖像)日後補充

確保你已經匯入並啟用正確的 Vuforia 圖像辨識資料庫，這是 AR 功能的核心。

這些設定完成後，才能進入 Unity 的 Build Settings 進行打包。

Unity Build Settings 設定教學

Unity 的 Build Settings 是將專案輸出成手機可執行檔的關鍵。以下是針對 Android 和 iOS 的主要設定步驟：

Android 平台設定(系統版本請參考官方)

1. 切換平台

   在 Build Settings 中選擇 Android，點擊「Switch Platform」切換。

   
   

2. Player Settings 調整

   • Package Name：設定唯一的應用程式識別碼，例如 com.yourcompany.yourapp。

   • Minimum API Level：建議選擇 Android 7.0（API 24）以上，確保兼容性。

   • 相機權限：確認已勾選相機使用權限。

   • Scripting Backend：選擇 IL2CPP 以提升效能與安全性。

   • Target Architectures：勾選 ARMv7 和 ARM64，確保大部分裝置支援。

   
   

3. Build System

   建議使用 Gradle，方便管理依賴與簽名。

   
   

iOS 平台設定

1. 切換平台

   在 Build Settings 中選擇 iOS，點擊「Switch Platform」。

   
   

2. Player Settings 調整

   • Bundle Identifier：設定唯一識別碼，例如 com.yourcompany.yourapp。

   • Target iOS Version：建議設定為 iOS 11.0 或以上。

   • 相機權限說明：在 Info.plist 中加入 NSCameraUsageDescription，說明為何需要使用相機。

   • Scripting Backend：選擇 IL2CPP。

   
   

3. Xcode 專案輸出

   Unity 會輸出一個 Xcode 專案，接著需要在 Xcode 中完成簽名與部署。

   
   

!中景角度展示 Unity Build Settings 視窗，顯示 Android 平台設定

Unity Build Settings 中 Android 平台的詳細設定

Android APK / AAB 打包流程(正式上市的應用程式的設定)

完成設定後，開始打包你的 Android AR 專案：

1. 選擇 Build Type

   • APK：適合測試與快速部署。

   • AAB（Android App Bundle）：適合上架 Google Play，能自動優化安裝包大小。

   
   

2. 簽名設定

   在 Player Settings 中設定簽名金鑰，若沒有可先建立一組 Debug Key 用於測試。

   
   

3. 開始打包

   點擊「Build」或「Build and Run」，Unity 會開始編譯並輸出 APK 或 AAB 檔案。

   
   

4. 安裝測試

   將 APK 安裝到 Android 裝置，確認 AR 功能正常運作。

   
   

注意事項

• 確認裝置已開啟相機權限。

• 若使用 AAB，上架前需在 Google Play Console 完成相關設定。

• 測試時建議使用真實裝置，模擬器無法完整支援 AR 功能。

  
  

iOS 實機部署流程

iOS 的打包流程較為複雜，需要透過 Xcode 進行：

1. 從 Unity 輸出 Xcode 專案

   在 Build Settings 選擇 iOS，點擊 Build，選擇輸出資料夾。

   
   

2. 開啟 Xcode 專案

   使用最新版本的 Xcode 開啟 Unity 輸出的專案。

   
   

3. 設定簽名與團隊

   在 Xcode 的 General 頁面設定 Apple Developer 團隊與簽名憑證。

   
   

4. 設定相機權限

   確認 Info.plist 中有 NSCameraUsageDescription 欄位。

   
   

5. 連接真機並執行

   將 iPhone 連接電腦，選擇裝置後點擊執行，Xcode 會將 App 安裝到手機。

   
   

6. 測試 AR 功能

   確認 Vuforia 的圖像辨識與 AR 內容正常顯示。

   
   
   
   

!近距離視角展示 iPhone 實機連接 Xcode 進行部署

iPhone 實機連接 Xcode，準備部署 Unity AR 專案