
本文翻譯自蘋果官方文檔,譯者:@星夜暮晨、@有情況_R。ResearchKit 是一個開源軟件框架,旨在幫助開發者與研究人員更便捷地創建研究型應用。它充分利用 iPhone 的傳感器與各項能力來記錄運動軌跡、測量數據並收集信息,讓研究者可以在任何地方開展研究與數據收集。
ResearchKit 提供了可靈活調整的模塊,涵蓋研究中最基礎的幾類必要元素:調研、授權與活動任務。你可以原封不動地使用這些模塊,在其基礎上擴展,甚至完全構建屬於自己的全新模塊。
通過科學且明確地設置問題與答案,用戶界面中預定義的調研模塊能讓你快速建立起一次調查。由於調研模型已經確定,你只需明確提出問題即可。更多內容可參見「創建調查」。
研究參與者往往需提供與研究相關的敏感信息,因此明確哪些信息被收集、誰會接觸這些信息至關重要。ResearchKit 提供了授權模板,你可以在此基礎上修改,用以闡明研究細節並獲取參與者的授權。更多內容可參閱「創建授權文檔」。
部分研究所需的數據可能來自調查問題,也可能來自 iOS 中 HealthKit、CoreMotion 等 API。活動任務邀請用戶在半受控的情況下,借助 iPhone 傳感器動態收集數據。更多內容可參閱「活動任務」。
在 ResearchKit 中,任務(ORKTask)可以是一系列預先安排好的行動序列,也可以是動態的——即之前的結果會影響接下來顯示的步驟。視圖控制器支持在一個漫長的任務中保存每一步的結果,並支持稍後重新加載數據與界面狀態,以防用戶在任務進行中退出應用。
無論是給出指導、展示調查表、包含授權還是運行活動任務,ResearchKit 中的一切都是步驟(ORKStep)的集合,這些步驟彙聚成任務(ORKTask)。要展示任務,需將其掛接到任務視圖控制器(ORKTaskViewController)上。當用戶完成任務中的每一步時,任務視圖控制器會生成記錄步驟起止時間及所有結果的步驟結果對象(ORKStepResult)。

在一個簡單的應用中,你可以直接用代碼創建任務,收集結果並序列化後存入硬盤,供之後人工分析。而大規模部署則可能動態地從服務器下載預定義調查,反序列化生成 ResearchKit 對象層級;任務結果同樣可被序列化並上傳到服務器以便後續分析。
隨著開源社區的不斷貢獻,ResearchKit 的特性將持續增長。目前它尚不包含以下功能:
後台傳感器數據收集(HealthKit、CoreMotion 等 API 已能實現)。
應用與服務器之間的安全通信機制,需自行提供。
為參與者規劃調查與活動任務。
數據必須是序列化後的、約定好的數據格式。所有 ResearchKit 對象都遵循 NSSecureCoding 協議,示例代碼中結果離開框架後會被序列化成 JSON。
你需對應用中所有涉及法律合規的內容承擔法律責任。
ResearchKit 支持 4 種日誌級別,分別對應四組預處理宏與日誌宏:
ORK_LOG_LEVEL_NONE ORK_LOG_LEVEL_DEBUG, ORK_Log_Debug() ORK_LOG_LEVEL_WARNING, ORK_Log_Warning() ORK_LOG_LEVEL_ERROR, ORK_Log_Error()
將 ORK_LOG_LEVEL_NONE 設為 1 會讓所有 ResearchKit 日誌完全靜默,優先於其他任何級別。將 ORK_LOG_LEVEL_DEBUG、ORK_LOG_LEVEL_WARNING 或 ORK_LOG_LEVEL_ERROR 設為 1,則會在該級別及更高級別開啟日誌。若不明確設置,默認使用 ORK_LOG_LEVEL_WARNING=1。
你必須在 ResearchKit 子項目中而非主任務中設置這些預處理宏。在 Xcode 中,可通過 ResearchKit 框架目標的 Build Settings 進行配置。若你通過 CocoaPods 使用 ResearchKit 並需修改日誌級別,可參考 stackoverflow 上關於「CocoaPods and custom Build Configurations」的相關資源。