Show Menu
主題×

iOS 延伸功能實施

您可以使用 iOS 延伸功能,以便從 Apple Watch 應用程式 (WatchOS 1)、Today 介面工具集、照片編輯介面工具集及其他 iOS 延伸功能應用程式收集使用資料。

新版 Adobe Experience Platform Mobile SDK

在尋找 Adobe Experience Platform Mobile SDK 的相關資訊和文件嗎? 按一下 這裡 以取得最新文件。
我們於 2018 年 9 月發行了全新的 SDK 主要版本。這些新的 Adobe Experience Platform Mobile SDK 可透過 Experience Platform Launch 設定。

對於使用 iOS SDK 而非自有包裝函式的建議

我們強烈建議您使用 iOS SDK,而非您自己的包裝函式。
Apple 會將要求傳送至容納應用程式,然後再接收回應,藉此提供一組讓 Watch 應用程式與容納應用程式通訊的 API。雖然您可以將追蹤資料當作字典,從 Watch 應用程式傳送到容納應用程式,然後再呼叫容納應用程式上的任何追蹤方法來傳送資料,不過這個解決方案有其限制。
在大部分的情況下,當使用者使用 Watch 應用程式時,容納應用程式會在背景執行,此時唯有呼叫 TrackActionInBackground TrackLocation TrackBeacon 是安全的。呼叫其他追蹤方法會干擾生命週期資料,所以若要從 Watch 應用程式傳送資料,您應該只使用這三個方法。
即使這三個追蹤方法已能滿足您的需求,仍應使用 iOS SDK,因為適用於 Watch 應用程式的 SDK 包含應用程式內傳訊之外的所有 Mobile 功能。

入門

確保您擁有至少具備以下目標的專案:
  • 一個要容納應用程式的目標。
  • 一個用於延伸功能的目標。
如果您正在使用 WatchKit 應用程式,則應具備第三個目標。如需 Apple Watch 開發的詳細資訊,請參閱 Apple Watch 開發

設定容納應用程式

在您的 Xcode 專案中完成以下步驟:
  1. 將 AdobeMobileLibrary 資料夾拖曳到專案中。
  2. 確認 ADBMobileConfig.json 檔案為容納應用程式目標的成員。
  3. 在容納應用程式目標的​ 「建立階段」 ​標籤中,展開​**「連結二進位檔與資料庫」]區段,然後新增下列資料庫:[**
    • AdobeMobileLibrary.a
    • libsqlite3.dylib
    • SystemConfiguration.framework
  4. 開啟容納應用程式目標的​ 功能 ​標籤,啟用​ 應用程式群組 ,然後新增應用程式群組 (例如 group.com.adobe.testAp )。
  5. 在與 Adobe Mobile 資料庫所有互動前,請在應用程式委派的 application:didFinishLaunchingWithOptions 中設定應用程式群組:
    [ADBMobile 
          setAppGroup:@"group.com.adobe.testApp"];
    
    
  6. 確認可建置應用程式且未發生非預期的錯誤。

設定擴充功能

  1. 確認 ADBMobileConfig.json 檔案為擴充功能目標的成員。
  2. 在延伸功能目標的​ 「建立階段」 ​標籤中,展開​**「連結二進位檔與資料庫」]區段,然後新增下列資料庫:[**
    • AdobeMobileLibrary_Extension.a
    • libsqlite3.dylib
    • SystemConfiguration.framework
  3. 開啟擴充功能目標的​ 功能 ​標籤,啟用​ 應用程式群組 ,然後選取您在上述​ 設定容納應用程式 ​的步驟 4 中新增的應用程式群組。
  4. 在與 Adobe Mobile 資料庫有所互動前,請在 InterfaceController 的 awakeWithContext: 中設定應用程式群組:
    [ADBMobile 
          setAppGroup:@"group.com.adobe.testApp"];
    
    
  5. 確認可建置應用程式且未發生非預期的錯誤。

其他附註

以下是一些要記住的資訊:
  • 已新增一個額外內容資料值 a.RunMode ,可指出資料來自容納應用程式還是延伸功能:
    • a.RunMode = Application
      此值表示該點擊來自容納應用程式。
    • a.RunMode = Extension
      此值表示該點擊來自延伸功能。
  • 如果您從舊版 SDK 升級,在啟動容納應用程式時,Adobe 會自動從容納應用程式的資料夾,移轉所有使用者預設值和快取檔案至應用程式群組的共用資料夾。
  • 如果從未啟動容納應用程式,則來自延伸功能的點擊會被捨棄。
  • 容納應用程式與延伸功能應用程式之間的版本編號和組建編號必須相同。
  • 在 iOS 延伸功能應用程式中不會觸發任何生命週期呼叫。