Xamarin.iOS 應用中的 iTunesMetadata.plist 文件

本文介紹了 iTunesMetadata.plist 文件,該文件用於向 iTunes 提供 iOS 應用程序使用 Ad Hoc 分發進行測試或企業部署的相關信息。 

在 iTunes Connect 中創建 iOS 應用程序(無論是用於在 iTunes App Store 中銷售還是免費發佈)時,開發人員可指定應用程序類型、子類型、版權聲明、支持的 iOS 設備和必需設備功能等信息。 對於通過 Ad Hoc 分發傳遞給測試員或企業用戶的 iOS 應用程序,缺少此信息。

若要向 Ad Hoc 分發提供缺少的信息,可選擇創建可選的 iTunesMetadata.plist 文件,然後將其包含在應用程序 IPA 文件中。 此 plist 文件是特殊格式的 XML 文件(詳情請參閱屬性列表編程指南),其中包含定義給定 iOS 應用程序相關信息的鍵/值對。

iTunesMetadata.plist 內容

以下示例介紹了典型的 iTunesMetadata.plist 文件,該文件用於定義 Ad Hoc 分發所需的 iTunes 信息:


 

下面將詳細介紹各個鍵的值。

UIRequiredDeviceCapabilities

通過 UIRequiredDeviceCapabilities 鍵,iTunes 可瞭解 iOS 應用程序需要哪些設備特定的功能纔可在給定的 iOS 設備上安裝。 其提供作爲功能 (<key>...</key>) 和各功能布爾值的字典 (<dict>...</dict>)。 如果某功能的值爲 true,則必須顯示該功能。 若爲 false,則不可在設備上顯示該功能。 例如:


 

指定 iOS 設備必須在支持 ARM7 指令集並擁有前置攝像頭後纔可安裝該應用程序。 有關允許值的完整列表,請參閱 Apple 的 UIRequiredDeviceCapabilities 文檔。

artistName 和 playlistArtistName

artistName 和 playlistArtistName 鍵用於定義創建要在 iTunes 內顯示的 iOS 應用程序的公司名稱。 示例:


 

bundleDisplayName、itemName 和 playlistName

bundleDisplayNameitemName 和 playlistName 鍵用於定義將在 iTunes 中顯示的 iOS 應用程序的名稱。 示例:


 

bundleShortVersionString 和 bundleVersion

bundleShortVersionString 和 bundleVersion 鍵用於定義將在 iTunes 中顯示的 iOS 應用程序版本號。 示例:


 

softwareVersionBundleId

softwareVersionBundleId 鍵用於指定 iOS 應用程序的程序包 ID。 示例:


 

copyright 鍵用於定義 iTunes 中顯示的版權聲明。 示例:


 

releaseDate

releaseDate 鍵用於提供要在 iTunes 中顯示的 iOS 應用程序的發佈日期。 示例:


 

softwareIconNeedsShine

softwareIconNeedsShine 鍵用於就 iOS 應用程序圖標是否需要對 iOS 6(及先前版本)使用高亮突出顯示 通知 iTunes。 示例:


 

gameCenterEnabled 和 gameCenterEverEnabled

gameCenterEnabled 和 gameCenterEverEnabled 鍵用於就此 iOS 應用程序是否支持 Apple Game Center 通知 iTunes 。 示例:


 

genre、genreId 和 subgenres

genre 和 genreId 鍵用於就此 iOS 應用程序屬於哪種類型通知 iTunes。 示例:


 

subgenres 鍵可選擇性地用於進一步定義 iOS 應用程序的子類型(最多兩個)。 示例:


 

對於 iOS 應用程序,Apple 當前定義以下的類型和類型 ID:

類型 ID 類型名稱
6000 業務
6001 天氣
6002 工具
6003 旅行
6004 體育遊戲
6005 社交
6006 參考
6007 工作效率
6008 攝像與錄影
6009 新聞
6010 導航
6011 音樂
6012 生活
6013 健康健美
6014 遊戲
6015 “財務”
6016 娛樂
6017 教育
6018 圖書
6020 醫療
6021 報刊雜誌
6022 商品指南

遊戲 (6014) 子類型:

類型 ID 類型名稱
7001 操作
7002 冒險遊戲
7003 街機遊戲
7004
7005 卡牌遊戲
7006 娛樂場遊戲
7007 骰子游戲
7008 教育類遊戲
7009 系列
7010 兒童遊戲
7011 音樂
7012 益智解謎
7013 賽車遊戲
7014 角色扮演遊戲
7015 模擬遊戲
7016 體育遊戲
7017 策略
7018 問答遊戲
7019

Newstand (6021) 子類型:

類型 ID 類型名稱
13001 新聞及政治
13002 流行與時尚
13003 家居與園藝
13004 戶外與自然
13005 運動與休閒
13006 汽車
13007 藝術與攝影
13008 新娘與婚禮
13009 商務與投資
13010 兒童雜誌
13011 電腦與網絡
13012 烹飪與飲食
13013 手工藝與愛好
13014 電子產品與音響
13015 娛樂
13017 健康、心理與生理
13018 歷史記錄
13019 文學雜誌與期刊
13020 男士興趣
13021 電影與音樂
13023 子女教養與家庭
13024 寵物
13025 職業與技能
13026 地方新聞
13027 科學
13028 青少年
13029 旅遊與地域
13030 女士興趣

有關詳細信息,請參閱 Apple 的 Genre IDs Appendix(類型 ID 附錄)文檔。

softwareSupportedDeviceIds

softwareSupportedDeviceIds 鍵用於就此 iOS 應用程序支持哪些 iOS 設備通知 iTunes。 示例:


 

其中以下值可用:

  • 1 – 經典 iPhone
  • 2 – iPod Touch
  • 4 – iPad
  • 9 – 新型 iPhone

標準鍵

以下鍵內附在 iOS 應用程序的所有 iTunesMetadata.plist 文件中,且始終使用相同的值:


 

創建 iTunesMetadata.plist 文件

在 Visual Studio for Mac 中使用 iTunesMetadata.plist 文件時,有兩種選擇:

下面將詳細介紹這兩種選擇。

使用可視化 Plist 編輯器

請執行以下操作:

  1. 在“解決方案資源管理器” 中,右鍵單擊 Xamarin.iOS 項目文件,再依次選擇“添加” > “新文件...” 

  2. 在“新文件”對話框中,依次選擇“iOS” > “屬性列表” :

  3. 對“名稱” 輸入 iTunesMetadata,然後單擊“新建” 按鈕。

  4. 在“解決方案資源管理器” 中,雙擊打開 iTunesMetadata.plist 文件進行編輯:

  5. 單擊綠色的“+” 新建條目,再輸入“UIRequiredDeviceCapabilities”作爲鍵名稱:

  6. 單擊“字符串” 值類型,再從彈出列表中選擇“字典” :

  7. 單擊屬性名左側的摺疊圖標,以顯示字典條目:

  8. 依次單擊“添加新條目” 文本和綠色的“+” ,向字典添加條目:

  9. 輸入“armv7”作爲鍵名稱,選擇“布爾” 類型,再輸入“Yes” 作爲值:

  10. 重複上述步驟,直到已使用所有必需鍵/值對填充 iTunesMetadata.plist 文件(有關詳細信息,請參閱上方的 iTunesMetadata.plist 內容部分)。

  11. 保存對 plist 文件的更改。

使用純文本編輯器

請執行以下操作:

  1. 在純文本編輯器中,新建文本文件並將其命名爲 iTunesMetadata.plist
  2. 複製上面的 iTunesMetadata.plist 內容中的示例內容。
  3. 將內容粘貼到文件並按需進行編輯。
  4. 保存文件並返回 Visual Studio for Mac。
  5. 在“解決方案資源管理器” 中,右鍵單擊 Xamarin.iOS 項目文件,再依次選擇“添加” > “現有文件...” 。
  6. 在“打開文件”對話框中,選擇上面創建的 iTunesMetadata.plist 文件,然後單擊“確定” 按鈕。
  7. 將此文件的“生成操作” 保留設置爲“無” 。

稍後,準備在 IDE 中生成 IPA 時,請選擇此 iTunesMetadata.plist 文件。

總結

本文介紹了 iTunesMetadata.plist 文件,該文件可用於就 Ad Hoc 分發的 iOS 應用程序通知 iTunes。 它還介紹了 plist 文件中的標準鍵,以及如何在 Visual Studio 和 Visual Studio for Mac 中創建和維護該文件。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章