iOS 應用程式的自動布建

自動布建是將 .NET 多平臺應用程式 UI （.NET MAUI） iOS 應用程式部署至裝置的建議方法。 使用這種方法，Visual Studio 會自動建立和管理簽署識別、應用程式識別碼和布建配置檔。 開始自動布建程式之前，您應該確定您已將Apple開發人員帳戶新增至Visual Studio。 如需詳細資訊，請參閱 Apple帳戶管理。

將 Apple 開發人員帳戶新增至 Visual Studio 之後，您就可以使用任何相關聯的小組。 接著，您可以針對小組建立憑證、應用程式識別碼和配置檔。 小組標識碼也可用來建立將包含在布建配置檔中的應用程式標識碼前置詞，讓Apple確認應用程式可以部署到裝置。

重要

開始之前，請確定您已在Apple開發人員帳戶和App Store Connect 中接受任何使用者許可協定。

啟用自動佈建

將 Apple 開發人員帳戶新增至 Visual Studio 之後，您必須為 .NET MAUI 應用程式專案啟用自動布建：

1. 在 [方案總管] 中，以滑鼠右鍵按兩下 .NET MAUI 應用程式項目，然後選取 [屬性]。 然後，流覽至 [iOS > 套件組合簽署] 索引標籤，並確定 [配置] 下拉式清單中已選取 [自動布建]：

   

2. 在 [ 套件組合簽署 設定] 中，按兩下 [ 設定自動布建] 超連結。

3. 在 [設定 自動布建] 對話框中，選取您的小組。 Visual Studio 會嘗試自動布建專案，並指出程式是否已順利完成：

   

   如果自動布建失敗，[ 設定自動布建 ] 對話框會顯示錯誤的原因。

4. 在 [ 設定自動布建 ] 對話框中，按兩下 [ 確定 ] 按鈕以關閉對話框。

部署到裝置

在 .NET MAUI 應用程式項目中設定布建之後，可以使用 Visual Studio 將應用程式部署至裝置：

1. 在 Visual Studio 中，確定 IDE 已配對至 Mac 組建主機。 如需詳細資訊，請參閱 與Mac配對以進行iOS開發。

2. 確定您的 iOS 裝置已透過 USB 或 WiFi 連線到 Mac 組建主機。 如需無線部署的詳細資訊，請參閱 .NET MAUI iOS 應用程式的無線部署。

3. 在 Visual Studio 工具列中，使用 [偵錯目標] 下拉式清單選取 [iOS 遠端裝置]，然後選取連線到 Mac 組建主機的裝置：

   

4. 在 Visual Studio 工具列中，按綠色的 [開始] 按鈕，在遠端裝置上啟動應用程式：

   

注意

將 .NET MAUI iOS 應用程式部署至裝置的替代方法是使用熱重新啟動。 熱重新啟動可讓您從 Visual Studio 將 .NET MAUI 應用程式部署至 64 位本機 iOS 裝置，而不需要 Mac 組建主機。 如需詳細資訊，請參閱 使用熱重新啟動部署 iOS 應用程式。

執行自動布建

啟用自動布建時，如果發生下列任一情況，Visual Studio 會在必要時重新執行自動布建程式：

• iOS 裝置已插入 Mac。 這會自動檢查裝置是否已在您的Apple開發人員帳戶中註冊。 如果不是，它會新增它，併產生包含它的新布建配置檔。
• 應用程式的套件組合標識碼已變更。 這會更新應用程式識別碼，因此會建立包含此應用程式識別碼的新布建配置檔。
• Entitlements.plist 檔案中已啟用支援的功能。 這項功能將會新增至應用程式識別碼，併產生具有更新應用程式識別碼的新布建配置檔。 目前並非所有功能都受到支援。 如需功能的詳細資訊，請參閱 功能。

萬用字元應用程式識別碼

根據預設，自動布建會嘗試建立及使用通配符應用程式標識碼和布建配置檔，而不是根據應用程式的套件組合標識符明確應用程式識別碼。 通配符應用程式標識碼可減少在Apple開發人員帳戶中維護的配置檔和標識碼數目。 如需通配符應用程式識別碼的詳細資訊，請參閱 建立開發佈建配置檔。

在某些情況下，應用程式的權利需要明確的應用程式識別碼。 下列權利不支援萬用字元應用程式識別碼：

• 應用程式群組
• 相關聯的網域
• Apple Pay
• Game Center
• HealthKit
• HomeKit
• 作用區
• 在應用程式內購買
• 多重路徑
• NFC
• 個人 VPN
• 推播通知
• 無線配件組態

如果您的應用程式使用其中一項權利，Visual Studio 會嘗試建立明確的應用程式識別碼。

疑難排解

可能需要數小時的時間，才能核准新的Apple開發人員帳戶。 在帳戶核准之前，您將無法啟用自動布建。

如果自動布建程式失敗，並出現錯誤訊息 Authentication Service Is Unavailable，請登入 App Store Connect 或Apple Developer 帳戶 ，以檢查您是否已接受最新的服務合約。

在本機金鑰鏈中找不到憑證

如果您使用多部計算機進行開發，當您嘗試在機器上設定自動布建時，可能會收到下列錯誤訊息：「嘗試自動佈建專案時發生錯誤：「憑證：Apple Development：透過 API 建立（密鑰標識碼）」已經存在，但無法在本機 Keychain 中找到。 它可能已在另一部開發計算機上建立。 從該計算機匯入憑證和私鑰，或撤銷憑證，然後再試一次以自動建立新的憑證。'“：

這是因為當您使用多部計算機進行開發時，自動布建不會移除在機器之間手動複製憑證的需求。 這是因為建立憑證的私鑰只存在於建立憑證的電腦上。

若要探索開發機器中是否有所需的憑證，請在Visual Studio中移至 [工具 > 選項 > Xamarin > Apple 帳戶]。 然後，在 [ Apple 開發人員帳戶 ] 對話框中，選取小組，然後按兩下 [ 檢視詳細數據...] 按鈕：

如果機器上未安裝必要的憑證，[ 詳細 數據] 視窗會顯示憑證的[不在密鑰鏈中] 狀態。 在此案例中，特定憑證必須從以 .p12 格式建立的計算機匯出，然後使用 [ 匯入憑證 ] 按鈕匯入 Visual Studio。

注意

• 若要將憑證從 Mac 複製到另一部 Mac，請從 Mac 上建立憑證的 Keychain Access 導出憑證，然後將它匯入其他 Mac 上的 Keychain Access。
• 若要將憑證從 Mac 複製到 Windows 計算機，請從 Mac 上的 Keychain Access 匯出憑證，然後在 Windows 計算機上，使用 [ 匯入憑證] 按鈕將憑證 匯入 Visual Studio。
• 您無法將Visual Studio在 Windows 電腦上建立的憑證複製到另一部電腦，因為它受到密碼保護。

匯入憑證之後，Visual Studio 會將其狀態顯示為「有效」：

Visual Studio 接著應該可以自動布建專案。