開始使用 iOS

App Center SDK 使用模組化架構,因此您可以使用任何或所有服務。

您可以在 App center Sdk、一般資料保護規定常見問題頁面所收集的資料上,找到 app center 所收集資料的相關資訊。 此外, FAQ 還包含您需要為 App Store 隱私權設定提供的解答。

讓我們開始在您的應用程式中設定 App Center iOS SDK,以使用 App Center 分析和 App Center 損毀。 若要將 App Center 散發新增至您的應用程式,請查看 App Center 散發的檔。

1.Prerequisites

使用 App Center SDK 時必須符合下列需求:

  • 您的 iOS 專案是在 macOS 10.14.4 版或更新版本的 Xcode 11 或更新版本中設定。
  • 您的目標裝置是在 iOS 9.0 或更新版本上執行的裝置。
  • 您未使用任何其他程式庫來提供損毀報告功能 (僅適用于 App Center 損毀) 。
  • 如果您使用 CocoaPods 來整合 App Center,您需要 CocoaPods 1.10 版或更新版本。

App Center SDK 分析和損毀可透過 XCFramework 或 SwiftPM 與 Mac Catalyst 相容。

2. 在 App Center 入口網站中建立您的應用程式以取得應用程式秘密

如果您已在 App Center 入口網站中建立應用程式,則可以略過此步驟。

  1. 前往 appcenter.ms
  2. 註冊或登入,然後按下入口網站右上角的藍色按鈕,其中顯示 [ 新增 ],然後從下拉式功能表中選取 [新增 應用程式 ]。
  3. 輸入應用程式的名稱和選擇性描述。
  4. 選取 iOS 作為作業系統,並以 目標-C/Swift 作為平臺。
  5. 按一下右下方的按鈕,以顯示 [ 新增應用程式]。

建立應用程式之後,您可以在 app Center 入口網站的 設定 頁面上取得其 應用程式密碼。 在 設定 頁面的右上角,按一下 三個垂直點,然後選取 Copy app secret 以取得您的應用程式密碼。

3. 新增 App Center SDK 模組

您可以透過CocoapodsCarthageSwift 封裝管理員,或手動將二進位檔新增至您的專案,將適用于 iOS 的 app Center SDK 新增至您的應用程式。

注意

引進了 4.0.0 App Center 中斷變更的版本。 遵循 [ 遷移至 App CENTER SDK 4.0.0 和 更新版本] 區段,從舊版遷移 App center。

3.1 透過 Cocoapods 整合

注意

從執行于 Apple 晶片 Mac) 上執行的 Xcode 啟動的 ARM64 模擬器 (不受 CocoaPods 支援,請考慮使用其他整合方法來運作。

  1. 將下列相依性新增至 podfile ,以包含 App Center 分析和 App center 損毀至您的應用程式。 此動作會提取下列架構: AppCenterAppCenterAnalyticsAppCenterCrashes。 相反地,您可以在應用程式中指定所需的服務。 每個服務都有自己的 subspec,而且全都依賴 AppCenter。 它將會自動提取。

    # Use the following line to use App Center Analytics and Crashes.x
    pod 'AppCenter'
    
    # Use the following lines if you want to specify which service you want to use.
    pod 'AppCenter/Analytics'
    pod 'AppCenter/Crashes'
    pod 'AppCenter/Distribute'
    
  2. 執行 pod install 以安裝新定義的 pod,並開啟專案的 .xcworkspace

注意

如果您在 [!] Unable to find a specification for `AppCenter` 執行時看到錯誤 pod install ,請執行 pod repo update 以從 Cocoapods 儲存機制取得最新的 pod,然後執行 pod install

既然您已在應用程式中整合架構,現在可以開始使用 SDK 並利用 App Center 服務。

3.2 透過 Carthage 整合

以下步驟說明如何使用 Carthage 0.30 版或更高 版本,將 Xcode 專案中的 App Center SDK 整合,這是建立相依性並提供二進位架構的非集中式相依性管理員。

注意

Carthage 整合無法在 Xcode 12 中使用。 若要使其運作,請參閱 此 Carthage 指示

  1. 將下列相依性新增至 Cartfile ,以包含 App Center。 這些相依性會提取所有架構。 然後,您可以只連結您要在應用程式中使用的架構。

    # Use the following line to get the latest version of App Center
    github "microsoft/appcenter-sdk-apple"
    
    # Use the following line to get the specific version of App Center
    github "microsoft/appcenter-sdk-apple" ~> X.X.X
    
  2. 執行 carthage update 以將相依性提取至 Carthage/簽出 資料夾。 然後建立每個架構。

  3. 開啟應用程式目標的 [一般 設定] 索引標籤。從 Carthage/Build/iOS 資料夾將 AppCenterAppCenterAnalyticsAppCenterCrashes 架構 檔案拖放到 Xcode 的 Project Navigator。 需要 AppCenter ,才能啟動 SDK。 如果未新增至專案,則其他模組將無法運作,而且您的應用程式不會編譯。

  4. 將會出現一個對話方塊,請確定已核取您的應用程式目標。 然後按一下 [ 完成]。

    注意

    如果您 carthage copy-frameworks組建階段 中使用,則您不應該在該處新增 App Center sdk,因為它們是以靜態架構的形式來傳送。

既然您已在應用程式中整合架構,現在可以開始使用 SDK 並利用 App Center 服務。

3.3 透過 Swift 封裝管理員整合

  1. 在 [Xcode] 功能表中,按一下 [檔案 > Swift 套件] > 新增套件 相依性]。
  2. 在出現的對話方塊中,輸入存放庫 URL: https://github.com/microsoft/appcenter-sdk-apple.git
  3. 在 [ 版本] 中,選取 [下一步] ,並採用預設選項。
  4. 在 [ 封裝產品 ] 資料行中選擇所需的模組。

既然您已在應用程式中整合架構,現在可以開始使用 SDK 並利用 App Center 服務。

注意

如果您要透過 SwiftPM 整合 App Center,並且想要在應用程式的擴充目標中使用它,請確定您已 DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES 在設定中提供。 這是避免將模組連結至多個目標的 SwiftPM 限制所需的。

3.4 將二進位檔複製到您的專案以進行整合

以下步驟說明如何整合 Xcode 專案中已編譯的二進位檔,以設定 App Center 分析和 iOS 應用程式的 App Center 損毀。

注意

App Center SDK 支援使用 XCframework 。 如果您想要將 XCframeworks 整合到您的專案中,請從 [版本] 頁面下載 AppCenter-SDK-Apple-XCFramework.zip ,並將其解壓縮。 產生的資料夾內容不是平臺特定的,而是包含每個模組的 XCframeworks。 您可以用與一般架構相同的方式進行整合,如下所述。

  1. 下載以 zip 檔案形式提供的 App CENTER SDK 架構。

  2. 將檔案解壓縮,您會看到一個名為 AppCenter-SDK-Apple 的資料夾,其中包含每個平臺資料夾上每個 App Center 服務的不同架構。 專案中需要呼叫的架構, AppCenter 因為它包含不同模組之間共用的程式碼。

  3. 參數建立協力廠商程式庫的子目錄。

    • 最佳做法是,協力廠商程式庫通常位於子目錄中,通常稱為「 廠商」。 如果專案未以程式庫的子目錄進行組織,請立即建立 廠商 子目錄。
    • 在您的 Xcode 專案內建立名為「 廠商 」的群組,以模擬磁片上的檔案結構。
  4. 在搜尋工具中開啟解壓縮的 AppCenter-SDK-Apple 資料夾,然後將資料夾複製到您想要的位置中的專案資料夾。 此資料夾包含適用于 App Center SDK 所支援的其他平臺之子資料夾中的架構,因此您可能需要刪除不需要的子資料夾。

  5. 在 Xcode 中將 SDK 架構新增至專案:

    • 確定 (⌘ + 1) 可以看見 Project 的導覽器。
    • 現在,從上一個步驟中的位置 (,將 & 卸載 AppCenter frameworkAppCenterAnalyticsAppCenterCrashes ,) 到 Xcode 的 Project 導覽器中。 需要 AppCenter ,才能啟動 SDK。 如果未新增至專案,則其他模組將無法運作,而且您的應用程式不會編譯。
    • 將會出現一個對話方塊,請確定已核取您的應用程式目標。 然後按一下 [ 完成]。

既然您已在應用程式中整合架構,現在可以開始使用 SDK 並利用 App Center 服務。

4. 啟動 SDK

若要使用 App Center,請選擇您想要使用的模組 (s) 。 依預設,不會啟動任何模組,而且您必須在啟動 SDK 時呼叫每一個模組。

根據您所使用的生命週期,以下指示會稍有不同。 從 Xcode 12 開始,您可以選取兩個生命週期的其中一個:在 Xcode 12) 和 "UI 套件 AppDelegate" 中,預設會選取 [Swift UI 應用程式] (。 如果您使用的是 Xcode 11 或更低版本,則會使用 UI 套件 AppDelegate 生命週期。 如果您正在開發延伸模組,請參閱擴充功能開始使用 頁面

4.1 新增匯入語句

開啟專案的 AppDelegate 檔 (適用于 Ui 套件 AppDelegate 生命週期) 或 <ProjectName> 應用程式 swift 檔案 (適用于 swift ui 應用程式生命週期) 並新增下列匯入語句:

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;
import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 新增 start:withServices: 方法

UI 套件 AppDelegate

將初始化程式碼新增至 didFinishLaunchingWithOptions 委派方法。

Swift UI 應用程式生命週期

init() struct 在其中建立方法,並在其中新增初始化程式碼。

將此程式碼用於先前所述的方法,以啟動 SDK:

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

如果您有 Catalyst 應用程式,您可以同時傳遞 iOS 和 macOS 的應用程式秘密:

[MSACAppCenter start:@"ios={Your iOS App Secret};macos={Your macOS App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];
AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS App Secret}", services: [Analytics.self, Crashes.self])

如果您需要分別啟動 App Center 服務,您應該:

  1. 使用應用程式秘密設定或啟動它。
  2. 如果可以多次呼叫程式碼,請檢查是否已設定 App Center。
  3. 啟動必要的服務 (s) ,而不需要應用程式密碼。
[MSACAppCenter configureWithAppSecret:@"{Your App Secret}"];
if ([MSACAppCenter isConfigured]) {
   [MSACAppCenter startService:[MSACAnalytics class]];
   [MSACAppCenter startService:[MSACCrashes class]];
}
AppCenter.configure(withAppSecret: "{Your App Secret}")
if AppCenter.isConfigured {
    AppCenter.startService(Analytics.self)
    AppCenter.startService(Crashes.self)
}

4.3 將預留位置取代為您的應用程式密碼

請務必將文字取代為 {Your App Secret} 應用程式的實際值。 應用程式秘密可在 app Center 入口網站的 [開始使用] 頁面或 [設定] 頁面上找到。

開始使用頁面包含上述的程式碼範例,其中包含您的應用程式秘密,您可以複製並貼上整個範例。

上述範例顯示如何使用 start:withServices start(withAppSecret:services:) Swift) 方法的 (,並同時包含 App center 分析和 app center 當機。

如果您不想要使用這兩項服務的其中一種,請從上述方法呼叫中移除對應的參數。

除非您明確指定每個模組作為 start 方法中的參數,否則您無法使用該 App Center 服務。 此外, start:withServices start(withAppSecret:services:) SWIFT) API 的 (只能在應用程式的生命週期中使用一次–所有其他呼叫都會將警告記錄到主控台,而且只會提供第一個呼叫中包含的模組。

例如-如果您想要上架至 App Center Analytics,您應該修改 start:withServices start(withAppSecret:services:) SWIFT) API 呼叫的 (,如下所示:

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self])

很棒的是,您已將其設定為在 SDK 自動收集的入口網站上視覺化分析和損毀資料。

查看 App Center 分析 檔和 app center 損毀檔,以瞭解如何自訂和使用兩項服務的更先進功能。

若要瞭解如何開始使用應用程式內更新,請閱讀 App Center 散發的檔。