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 bundleDisplayName
içinde görüntülenecek iOS uygulamasının adını tanımlamak için , itemName
ve 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'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:
Çözüm Gezgini Xamarin.iOS proje dosyasına sağ tıklayın ve Yeni Dosya Ekle>... öğesini seçin.
Yeni Dosya İletişim Kutusunda iOS>Özellik Listesi'ni seçin:
Ad için girin
iTunesMetadata
ve Yeni düğmesine tıklayın.Çözüm Gezgini dosyaya çift tıklayarak
iTunesMetadata.plist
düzenlemek üzere açın:Yeni bir girdi oluşturmak için yeşile + tıklayın ve anahtar adı olarak girin
UIRequiredDeviceCapabilities
:Dize değer türüne tıklayın ve açılan listeden Sözlük'e tıklayın:
Sözlüğün girdilerini görüntülemek için Özellik adının sol tarafındaki açılan kutuya tıklayın:
Yeni girdi ekle metnine tıklayın ve ardından sözlüğe giriş eklemek için yeşile + tıklayın:
Anahtar adı olarak girin
armv7
, bir Boole türü seçin ve değer olarak Evet girin: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).Değişiklikleri plist dosyasına kaydedin.
Düz Metin Düzenleyicisi kullanma
Aşağıdakileri yapın:
- Düz metin düzenleyicisinde yeni bir metin dosyası oluşturun ve adını verin
iTunesMetadata.plist
. - Yukarıdaki iTunesMetadata.plist İçeriği bölümünden örnek içeriği kopyalayın.
- İçeriği dosyaya yapıştırın ve gerektiği gibi düzenleyin.
- Dosyayı kaydedin ve Mac için Visual Studio dönün.
- Çözüm Gezgini Xamarin.iOS proje dosyasına sağ tıklayın ve Varolan Dosyaları Ekle...'yi>seçin.
- Dosya Aç İletişim Kutusunda, yukarıda oluşturulan dosyayı seçin
iTunesMetadata.plist
ve Tamam düğmesine tıklayın. - 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.