Xamarin.iOS Uygulamalarında iTunesMetadata.plist Dosyası

Bu makale, test veya Kurumsal dağıtım için Geçici dağıtım kullanan bir iOS uygulaması hakkında iTunes'a bilgi sağlamak için kullanılan iTunesMetadata.plist dosyasını kapsar.

iTune Bağlan'de bir iOS uygulaması oluşturulduğunda (iTunes App Store'dan satış veya ücretsiz sürüm için), geliştirici uygulamanın türü, alt türü, telif hakkı bildirimi, desteklenen iOS cihazları ve gerekli cihaz özellikleri gibi bilgileri belirtebilir. Test edicilere veya Kurumsal kullanıcıya geçici dağıtım yoluyla teslim edilen iOS uygulamaları için bu bilgiler eksiktir.

Geçici dağıtıma eksik bilgileri sağlamak için, isteğe bağlı iTunesMetadata.plist bir dosya oluşturulabilir ve uygulamalar IPA dosyasına eklenebilir. Bu plist dosyası, belirli bir iOS uygulaması hakkında bilgi tanımlayan anahtar/değer çiftleri içeren özel olarak biçimlendirilmiş bir XML dosyasıdır (daha fazla bilgi için bkz. Apple Özellik Listesi Programlama Kılavuzu ).

iTunesMetadata.plist İçeriği

Geçici dağıtım için iTunes bilgilerini tanımlamak için kullanılan tipik iTunesMetadata.plist bir dosya örneği aşağıda verilmiştir:

<?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>

Tek tek anahtarların değerleri aşağıda ayrıntılı olarak ele alınacaktır.

UIRequiredDeviceCapabilities

Bu UIRequiredDeviceCapabilities tuş, belirli bir iOS cihazına yüklenebilmesi için iTunes'un bir iOS uygulamasının hangi cihaza özgü özellikleri gerektirdiğini bilmesini sağlar. Özellik sözlüğü (<dict>...</dict>) ve her özellik<key>...</key> için boole değeri olarak sağlanır. Bir özelliğin değeri ise true, bu özelliğin mevcut olması gerekir. Özellik buysa false cihazda mevcut olmamalıdır. Örneğin:

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

Bu uygulamanın cihaza yüklenebilmesi için iOS cihazının ARM7 yönerge kümesini desteklemesi ve ön kameraya sahip olması gerektiğini belirtir. İzin verilen değerlerin tam listesi için lütfen Apple'ın UIRequiredDeviceCapabilities belgelerine bakın.

artistName ve playlistArtistName

iTunes'da artistName görüntülenecek iOS uygulamasını oluşturan şirketin adını tanımlamak için ve playlistArtistName tuşlarını kullanın. Örnek:

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

bundleDisplayName, itemName ve playlistName

iTunes'un bundleDisplayNameiçinde görüntülenecek iOS uygulamasının adını tanımlamak için , itemNameve playlistName tuşlarını kullanın. Örnek:

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

bundleShortVersionString ve bundleVersion

iTunes'da bundleShortVersionString görüntülenecek iOS uygulama sürüm numarasını tanımlamak için ve bundleVersion tuşlarını kullanın. Örnek:

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

softwareVersionBundleId

iOS uygulamasının softwareVersionBundleId Paket Kimliğini belirtmek için anahtarını kullanın. Örnek:

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

telif hakkı

iTunes'da copyright görüntülenen telif hakkı bildirimini tanımlamak için anahtarını kullanın. Örnek:

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

Releasedate

iTunes'da releaseDate görüntülenecek iOS uygulaması için bir yayın tarihi sağlamak için anahtarını kullanın. Örnek:

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

softwareIconNeedsShine

iOS Uygulamasının simgesinin softwareIconNeedsShine iOS 6 (ve öncesi) için parlak bir vurgu gerektirdiğini iTunes'a bildirmek için tuşunu kullanın. Örnek:

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

gameCenterEnabled ve gameCenterEverEnabled

iTunes'a bu iOS uygulamasının gameCenterEnabled Apple'ın Oyun Merkezi'ni desteklediğini söylemek için ve gameCenterEverEnabled tuşlarını kullanın. Örnek:

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

genre, genreId ve subgenres

iOS uygulamasının genre hangi türe ait olduğunu iTunes'a söylemek için ve genreId tuşlarını kullanın. Örnek:

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

İsteğe bağlı olarak subgenres anahtar, iOS uygulaması için en fazla iki alt türü tanımlamak için kullanılabilir. Örnek:

<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>

Apple, iOS uygulamaları için şu anda aşağıdaki türleri ve tür kimliklerini tanımlar:

Tür Kimliği	Tür Adı
6000	İşletme
6001	Hava Durumu
6002	Yardımcı Programlar
6003	Seyahat
6004	Spor
6005	Sosyal Ağ
6006	Başvuru
6007	Üretkenlik
6008	Fotoğraf ve Video
6009	Haberler
6010	Gezinti
6011	Müzik
6012	Yaşam tarzı
6013	Sağlık ve Fitness
6014	Oyunlar
6015	Finance
6016	Eğlence
6017	Eğitim
6018	Defterler
6020	Tıbbi
6021	Haber Çubuğu
6022	Kataloglar

Oyunlar (6014) alt türleri:

Tür Kimliği	Tür Adı
7001	Eylem
7002	Macera
7003	Arcade
7004	Kurulu
7005	Kart
7006	Casino
7007	Zar
7008	Eğitim
7009	Aile
7010	Çocuklar
7011	Müzik
7012	Bulmaca
7013	Yarış
7014	Rol yapma
7015	Simülasyon
7016	Spor
7017	Strateji
7018	Trivia
7019	Word

Newstand (6021) alt türleri:

Tür Kimliği	Tür Adı
13001	Haberler ve Politika
13002	Moda ve Stil
13003	Ev ve Bahçe
13004	Dış Mekan ve Doğa
13005	Spor ve Eğlence
13006	Otomotiv
13007	Sanat ve Fotoğraf
13008	Gelinler ve Düğünler
13009	İş ve Yatırım
13010	Çocuk Dergileri
13011	Bilgisayarlar ve İnternet
13012	Yemek, Yiyecek ve İçecek
13013	El Sanatları ve Hobiler
13014	Elektronik ve Ses
13015	Eğlence
13017	Sağlık, Zihin ve Vücut
13018	Geçmiş
13019	Edebiyat Dergileri ve Dergiler
13020	Erkek İlgi Alanı
13021	Filmler ve Müzik
13023	Ebeveynlik ve Aile
13024	Evcil hayvan
13025	Profesyonel & Ticaret
13026	Bölgesel Haberler
13027	Bilim
13028	Gençler
13029	Seyahat & Bölgesel
13030	Kadın İlgi Alanı

softwareSupportedDeviceIds

Bu iOS uygulamasının softwareSupportedDeviceIds hangi iOS cihazlarını desteklediğini iTunes'a bildirmek için tuşunu kullanın. Örnek:

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

Aşağıdaki değerlerin kullanılabildiği yerler:

• 1 – Klasik i Telefon s
• 2 – iPod Touch
• 4 – iPad
• 9 – Modern i Telefon s

Standart Anahtarlar

Aşağıdaki anahtarlar iOS uygulamalarının tüm iTunesMetadata.plist dosyalarına eklenir ve her zaman aynı değerlere sahiptir:

<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 Dosyası Oluşturma

Mac için Visual Studio

Mac için Visual Studio'da bir iTunesMetadata.plist dosyayla çalışırken iki seçeneğiniz vardır:

• Mac için Visual Studio görsel plist düzenleyicisini kullanarak dosyayı oluşturun ve koruyun.
• Dosyayı düz metin düzenleyicisinde oluşturun ve koruyun.

Her iki seçenek de aşağıda ayrıntılı olarak ele alınacaktır.

Visual Plist Düzenleyicisi'ni kullanma

Aşağıdakileri yapın:

1. Çözüm Gezgini Xamarin.iOS proje dosyasına sağ tıklayın ve Yeni Dosya Ekle>... öğesini seçin.

2. Yeni Dosya İletişim Kutusunda iOS>Özellik Listesi'ni seçin:

   

3. Ad için girin iTunesMetadata ve Yeni düğmesine tıklayın.

4. Çözüm Gezgini dosyaya çift tıklayarak iTunesMetadata.plist düzenlemek üzere açın:

   

5. Yeni bir girdi oluşturmak için yeşile + tıklayın ve anahtar adı olarak girin UIRequiredDeviceCapabilities :

   

6. Dize değer türüne tıklayın ve açılan listeden Sözlük'e tıklayın:

   

7. Sözlüğün girdilerini görüntülemek için Özellik adının sol tarafındaki açılan kutuya tıklayın:

   

8. Yeni girdi ekle metnine tıklayın ve ardından sözlüğe giriş eklemek için yeşile + tıklayın:

   

9. Anahtar adı olarak girinarmv7, bir Boole türü seçin ve değer olarak Evet girin:

   

10. Dosyayı gerekli tüm anahtar/değer çiftleriyle doldurana iTunesMetadata.plist kadar yukarıdaki adımları yineleyin (daha fazla ayrıntı için yukarıdaki iTunesMetadata.plist İçeriği bölümüne bakın).

11. Değişiklikleri plist dosyasına kaydedin.

Düz Metin Düzenleyicisi kullanma

Aşağıdakileri yapın:

1. Düz metin düzenleyicisinde yeni bir metin dosyası oluşturun ve adını verin iTunesMetadata.plist.
2. Yukarıdaki iTunesMetadata.plist İçeriği bölümünden örnek içeriği kopyalayın.
3. İçeriği dosyaya yapıştırın ve gerektiği gibi düzenleyin.
4. Dosyayı kaydedin ve Mac için Visual Studio dönün.
5. Çözüm Gezgini Xamarin.iOS proje dosyasına sağ tıklayın ve Varolan Dosyaları Ekle...'yi>seçin.
6. Dosya Aç İletişim Kutusunda, yukarıda oluşturulan dosyayı seçin iTunesMetadata.plist ve Tamam düğmesine tıklayın.
7. Bu dosyanın Derleme Eylemi'ni Yok olarak bırakın.

Visual Studio

Visual Studio için Xamarin eklentisi yalnızca ve Entitlement.plist dosyaları için Info.plist görsel düzenleyiciyi destekler, bu nedenle dosyanızı iTunesMetadata.plist standart bir metin düzenleyicisinde oluşturmanız ve Xamarin.iOS projenize el ile eklemeniz gerekir.

Aşağıdakileri yapın:

1. Düz metin düzenleyicisinde yeni bir metin dosyası oluşturun ve adını verin iTunesMetadata.plist.
2. Yukarıdaki iTunesMetadata.plist İçeriği bölümünden örnek içeriği kopyalayın.
3. İçeriği dosyaya yapıştırın ve gerektiği gibi düzenleyin.
4. Dosyayı kaydedin ve Visual Studio'ya dönün.
5. Çözüm Gezgini Xamarin.iOS proje dosyasına sağ tıklayın ve Varolan Dosyaları Ekle...'yi>seçin.
6. Dosya Aç İletişim Kutusunda, yukarıda oluşturduğunuz dosyayı seçin iTunesMetadata.plist ve Aç düğmesine tıklayın.
7. Bu dosyanın Derleme Eylemi'ni Yok olarak bırakın.

Daha sonra, IDE'de IPA'nızı oluşturmaya hazırlanırken bu iTunesMetadata.plist dosyayı seçin.

Özet

Bu makale, iTunes'a geçici teslim edilen bir iOS uygulaması hakkında bilgi vermek için kullanılabilecek dosyayı ele almıştır iTunesMetadata.plist . Bu, plist dosyasındaki standart anahtarı ve Visual Studio ve Mac için Visual Studio'de dosyanın nasıl oluşturulup tutulacağını anlatmıştır.

İlişkili Bağlantılar

• App Store Dağıtımı
• iTunes Bağlan'da Uygulama Yapılandırma
• App Store’da Yayımlama
• Şirket İçi Dağıtım
• Geçici Dağıtım
• IPA Desteği
• Sorun giderme