Xamarin.iOS アプリの iTunesMetadata.plist ファイル

この記事では、テストまたはエンタープライズ展開のためのアドホックな配布を使って iOS アプリケーションに関する情報を iTunes に提供するために使われる iTunesMetadata.plist ファイルについて説明します。

iTunes App Store での販売または無料リリースのために iOS アプリケーションを iTunes Connect で作成するとき、開発者はアプリケーションのジャンル、サブジャンル、著作権の通知、サポートされている iOS デバイス、必要なデバイス機能などの情報を指定できます。 アドホック配布によってテスト担当者またはエンタープライズ ユーザーに配信される iOS アプリケーションの場合は、この情報はありません。

不足している情報をアドホック配布に提供するには、省略可能な iTunesMetadata.plist ファイルを作成して、アプリケーションの IPA ファイルに含めることができます。 この plist ファイルは特殊な形式の XML ファイルであり (詳しくは Apple の「Property List Programming Guide」(プロパティ リスト プログラミング ガイド) をご覧ください)、特定の iOS アプリケーションに関する情報を定義するキー/値ペアが含まれます。

iTunesMetadata.plist の内容

アドホック配布用の iTunes 情報の定義に使われる一般的な iTunesMetadata.plist ファイルの例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>UIRequiredDeviceCapabilities</key>
    <dict>
        <key>armv7</key>
        <true/>
        <key>front-facing-camera</key>
        <true/>
    </dict>
    <key>artistName</key>
    <string>Company, Inc.</string>
    <key>bundleDisplayName</key>
    <string>App Name</string>
    <key>bundleShortVersionString</key>
    <string>1.5.1</string>
    <key>bundleVersion</key>
    <string>1.5.1</string>
    <key>copyright</key>
    <string>© 2015 Company, Inc.</string>
    <key>drmVersionNumber</key>
    <integer>0</integer>
    <key>fileExtension</key>
    <string>.app</string>
    <key>gameCenterEnabled</key>
    <false/>
    <key>gameCenterEverEnabled</key>
    <false/>
    <key>genre</key>
    <string>Games</string>
    <key>genreId</key>
    <integer>6014</integer>
    <key>itemName</key>
    <string>App Name</string>
    <key>kind</key>
    <string>software</string>
    <key>playlistArtistName</key>
    <string>Company, Inc.</string>
    <key>playlistName</key>
    <string>App Name</string>
    <key>releaseDate</key>
    <string>2015-11-18T03:23:10Z</string>
    <key>s</key>
    <integer>143441</integer>
    <key>softwareIconNeedsShine</key>
    <false/>
    <key>softwareSupportedDeviceIds</key>
    <array>
        <integer>9</integer>
    </array>
    <key>softwareVersionBundleId</key>
    <string>com.company.appid</string>
    <key>subgenres</key>
    <array>
        <dict>
            <key>genre</key>
            <string>Puzzle</string>
            <key>genreId</key>
            <integer>7012</integer>
        </dict>
        <dict>
            <key>genre</key>
            <string>Word</string>
            <key>genreId</key>
            <integer>7019</integer>
        </dict>
    </array>
    <key>versionRestrictions</key>
    <integer>16843008</integer>
</dict>
</plist>

個々のキーの値については後で詳しく説明します。

UIRequiredDeviceCapabilities

UIRequiredDeviceCapabilities キーにより、iTunes は、特定の iOS デバイスにインストールする前に、iOS アプリケーションに必要なデバイス固有機能を認識できます。 機能 (<key>...</key>) の辞書 (<dict>...</dict>) と各機能のブール値として提供されます。 機能の値が true の場合、その機能は存在する必要があります。 false の場合、その機能はデバイスに存在することはできません。 次に例を示します。

<key>UIRequiredDeviceCapabilities</key>
<dict>
    <key>armv7</key>
    <true/>
    <key>front-facing-camera</key>
    <true/>
</dict>

このアプリケーションをデバイスにインストールする前に、iOS デバイスが ARM7 命令をサポートし、前面カメラを持っている必要があることを指定します。 指定できる値の完全な一覧については、Apple のドキュメントで UIRequiredDeviceCapabilities をご覧ください。

artistName、playlistArtistName

artistName および playlistArtistName キーは、iTunes に表示される iOS アプリケーション作成会社の名前を定義するために使います。 例:

<key>artistName</key>
<string>Company, Inc.</string>
...
<key>playlistArtistName</key>
<string>Company, Inc.</string>

bundleDisplayName、itemName、playlistName

bundleDisplayName、itemName、playlistName キーは、iTunes 内に表示される iOS アプリケーションの名前を定義するために使います。 例:

<key>bundleDisplayName</key>
<string>App Name</string>
...
<key>itemName</key>
<string>App Name</string>
...
<key>playlistName</key>
<string>App Name</string>

bundleShortVersionString、bundleVersion

bundleShortVersionString および bundleVersion キーは、iTunes に表示される iOS アプリケーションのバージョン番号を定義するために使います。 例:

<key>bundleShortVersionString</key>
<string>1.5.1</string>
<key>bundleVersion</key>
<string>1.5.1</string>

softwareVersionBundleId

softwareVersionBundleId キーは、iOS アプリケーションのバンドル ID を指定するために使います。 例:

<key>softwareVersionBundleId</key>
<string>com.company.appid</string>

著作権

copyright キーは、iTunes に表示される著作権の告知を定義するために使います。 例:

<key>copyright</key>
<string>© 2015 Company, Inc.</string>

releaseDate

releaseDate キーは、iTunes に表示される iOS アプリケーションのリリース日を指定するために使います。 例:

<key>releaseDate</key>
<string>2015-11-18T03:23:10Z</string>

softwareIconNeedsShine

softwareIconNeedsShine キーは、iOS 6 (およびそれより前) の場合に iOS アプリケーションのアイコンを "明るく強調する" 必要があるかどうかを iTunes に伝えるために使います。 例:

<key>softwareIconNeedsShine</key>
<false/>

gameCenterEnabled、gameCenterEverEnabled

gameCenterEnabled および gameCenterEverEnabled キーは、この iOS アプリケーションが Apple の Game Center をサポートしているかどうかを iTunes に伝えるために使います。 例:

<key>gameCenterEnabled</key>
<false/>
<key>gameCenterEverEnabled</key>
<false/>

genre、genreId、subgenres

genre および genreId キーは、iOS アプリケーションのジャンルを iTunes に伝えるために使います。 例:

<key>genre</key>
<string>Games</string>
<key>genreId</key>
<integer>6014</integer>

必要に応じて、subgenres キーを使って iOS アプリケーションのサブジャンルを最大 2 個まで追加定義できます。 例:

<key>subgenres</key>
<array>
    <dict>
        <key>genre</key>
        <string>Puzzle</string>
        <key>genreId</key>
        <integer>7012</integer>
    </dict>
    <dict>
        <key>genre</key>
        <string>Word</string>
        <key>genreId</key>
        <integer>7019</integer>
    </dict>
</array>

iOS アプリケーションの場合、現在定義されているジャンルとジャンル ID は次のとおりです。

ゲーム (6014) のサブジャンル:

雑誌・新聞 (6021) のサブジャンル:

softwareSupportedDeviceIds

softwareSupportedDeviceIds キーは、この iOS アプリケーションがサポートしている iOS デバイスを iTunes に伝えるために使います。 例:

<key>softwareSupportedDeviceIds</key>
<array>
    <integer>9</integer>
</array>

有効な値は次のとおりです。

• 1 – クラシック iPhone
• 2 – iPod Touch
• 4 – iPad
• 9 – 最新の iPhone

標準キー

以下のキーは、iOS アプリケーションのすべての iTunesMetadata.plist ファイルに含まれ、常に同じ値に設定されます。

<key>drmVersionNumber</key>
<integer>0</integer>
<key>fileExtension</key>
<string>.app</string>
...
<key>kind</key>
<string>software</string>
...
<key>s</key>
<integer>143441</integer>
...
<key>versionRestrictions</key>
<integer>16843008</integer>

iTunesMetadata.plist ファイルの作成

その後、IDE で IPA のビルドを準備するときに、この iTunesMetadata.plist ファイルを選びます。

まとめ

この記事では、アドホックに配信される iOS アプリケーションについて iTunes に伝えるために使うことができる iTunesMetadata.plist ファイルについて説明しました。 plist ファイルの標準キーについて説明し、Visual Studio と Visual Studio for Mac. でファイルを作成して保守する方法について説明しました。

関連リンク

• App Store の配布
• iTunes Connect でのアプリの構成
• App Store への発行
• 社内配布
• アドホック配布
• IPA のサポート
• トラブルシューティング