Synopsis
actool [seçenekler] doküman
Description
actool, bir varlık kataloğunun içeriğini doğrular, günceller ve yazdırır; çıktısını standart plist formatında üretir. Araç, "oku", "değiştir", "yaz", "yazdır" işlem sırasını takip eder.
Options
Çıktıyı Belirtme: --output-format format Varsayılan olarak actool, çıktıyı bir XML özellik listesi (property list) biçiminde sunar. binary1 belirtilmesi, actool'a ikili (binary) bir özellik listesi çıktılamasını söyler. Benzer şekilde, xml1 bir XML özellik listesini belirtir ve human-readable-text ise insan tarafından okunabilir metni belirtir.
Derleme: --compile yol Dokümanı derler ve çıktıyı belirtilen dizin yoluna yazar. CAR dosyasının adı Assets.car olacaktır. Derleme seçeneği actool'a, bir varlık kataloğunu çalışma zamanı için optimize edilmiş dosyalara dönüştürmesini söyler. Ek olarak, --warnings, --errors ve --output-format seçenekleri, --compile seçeneği ile yaygın olarak birleştirilen diğer üç seçenektir.
--warnings Doküman uyarı mesajlarını actool'un plist çıktısına dahil eder. Uyarılar, com.apple.actool.document.warnings anahtarı altında görünecektir; mesajlar message alt anahtarı altında ve uyarı türleri type alt anahtarı altında listelenir.
--errors Doküman hata mesajlarını actool'un plist çıktısına dahil eder. Hatalar, com.apple.actool.document.errors anahtarı altında görünecektir; mesajlar message alt anahtarı altında ve hata türleri type alt anahtarı altında listelenir.
--notices Doküman bildirim mesajlarını actool'un plist çıktısına dahil eder. Bildirimler, com.apple.actool.document.notices anahtarı altında görünecektir; mesajlar message alt anahtarı altında ve hata türleri type alt anahtarı altında listelenir.
--output-partial-info-plist yol Belirtilen yola, bir uygulamanın info plist dosyasına dahil edilecek anahtarları ve değerleri içeren bir plist dosyası çıkarır. yol, info plist dosyasının tam yoludur ve .plist dosya uzantısı belirtilmiş olmalıdır. Plist, CAR dosyası derlenirken toplanan bilgilerle doldurulur ve şu anda proje tarafından kullanılan uygulama simgesi (app icon) ve lansman görselleri (launch images) hakkında bilgiler içerir. Yapılandırmalar (builds) sırasında, burada üretilen bilgiler hedef paketin (target bundle) Info.plist dosyası ile birleştirilecektir.
--app-icon ad Bir birincil uygulama simgesi seçmek için --compile ile birleştirilebilir. Uygulama simgesi, --minimum-deployment-target değerine bağlı olarak ya --compile tarafından belirtilen çıktı dizinine kopyalanır ya da oluşturulan CAR dosyasının içine dahil edilir. macOS 10.13 veya iOS 11.0 ve sonraki sürümlerine dağıtım yapmak, uygulama simgesinin oluşturulan CAR dosyasına dahil edilmesine neden olur. Kısmen tanımlanmış bir görsel yine de çıktı yolunda oluşturulur, ancak bu davranış gelecekte ortadan kalkabilir. Bu bayrak aynı zamanda actool'un uygulama simgesini --output-partial-info-plist tarafından belirtilen kısmi info plist bileşeninde beyan etmesini sağlar.
--include-all-app-icons Derleme sırasında, tüm adlandırılmış kataloglardaki tüm uygulama simgesi varlıklarının derlenmiş CAR dosyasına dahil edilmesini sağlar. --app-icon değeri birincil uygulama simgesi olacak ve ek simge adları kısmi info plist dosyasına eklenecektir.
--alternate-app-icon ad Derlenmiş CAR dosyasına dahil edilecek ve kısmi info plist dosyasında listelenecek ek bir uygulama simgesi seti adı belirtir. Birden fazla kez belirtilebilir. Bu, daha ayrıntılı kontrol sağlayan --include-all-app-icons seçeneğine bir alternatiftir.
--launch-image ad Çoğu platform için çıktı dizinine derlenecek bir lansman görseli seçmek üzere --compile ile birleştirilebilir. tvOS üzerinde, lansman görseli sonuçta oluşan CAR dosyasının içine derlenir. Bu bayrak aynı zamanda actool'un lansman görselini --output-partial-info-plist tarafından belirtilen kısmi info plist bileşeninde beyan etmesini sağlar.
--accent-color ad Hedefin birincil vurgu veya ton rengi olarak kullanılacak adlandırılmış bir renk seçer. Referans verilen renk eksikse bir uyarı oluşturulur. Renk mevcut olduğunda ve boş olmayan bir değere sahip olduğunda, NSAccentColorName anahtarı --output-partial-info-plist tarafından belirtilen kısmi info plist dosyasına eklenir.
--widget-background-color ad Hedef bir pencere öğesi (widget) ise, arka plan rengi olarak kullanılacak adlandırılmış bir renk seçer. Referans verilen renk eksikse bir uyarı oluşturulur. Renk mevcut olduğunda ve boş olmayan bir değere sahip olduğunda, renk adı --output-partial-info-plist tarafından belirtilen kısmi info plist dosyasına eklenir.
--skip-app-store-deployment Doğrulamalar gibi App Store'a özgü davranışlerin gerçekleştirilip gerçekleştirilmeyeceğini belirtir. Örneğin, bir iOS veya watchOS uygulaması için derleme yaparken, 1024 App Store simgesi mevcut değilse bir uyarı verilir, ancak bu yalnızca App Store dağıtımı için derleme yapılırken geçerlidir. App Store'a gönderilmesi amaçlanmayan hedefler için --skip-app-store-deployment seçeneğini geçmek isteyebilirsiniz.
--include-language dil Varlık kataloğu derlemesini yalnızca belirtilen dili içerecek şekilde filtreler. Bu seçenek, birden fazla dili dahil etmek için birden fazla kez belirtilebilir (örneğin, --include-language en --include-language fr --include-language de). Bu seçenek, hedef dağıtım için gerekli olmayan yerelleştirmeleri hariç tutarak derlenmiş CAR dosyasının boyutunu azaltır. Yerel ayara göre değişmeyen varlıklar veya geliştirme dili (development language, --development-region tarafından belirtilir) için belirlenmiş olanlar, bu ayardan bağımsız olarak her zaman dahil edilir. Bu seçenek belirtilmezse, mevcut tüm dil varyantları dahil edilir.
--include-partial-info-plist-localizations yes|no Etkinleştirildiğinde, seçilen varlıkların yerelleştirme bilgilerini CFBundleLocalizations anahtarı altında oluşturulan kısmi Info.plist dosyasına dahil eder. Bu, pakette karşılık gelen bir lproj dizini olmasa bile varlıkların çalışma zamanında kullanılmasına olanak tanır. Varsayılan değer YES'tir.
--platform platform-adı Derleme yapılacak hedef platformu belirtir. Bu seçenek uyarıları, doğrulamayı ve oluşturulan ürüne hangi görsellerin dahil edileceğini etkiler.
--minimum-deployment-target sürüm Derleme yapılacak minimum dağıtım hedefini belirtir. Bu seçenek uyarıları, doğrulamayı ve oluşturulan ürüne hangi görsellerin dahil edileceğini etkiler.
--standalone-icon-behavior default|all|none İçeriği Assets.car dosyasına dahil etmenin yanı sıra, uygulama simgesi için bağımsız PNG veya ICNS dosyalarının oluşturulup oluşturulmayacağını kontrol eder. Varsayılan olarak, boyutların küçük bir alt kümesi bağımsız dosyalar olarak dahil edilir ve bu da harici yönetim araçlarının CAR dosyasını okumadan temsilci bir simge görüntülemesine olanak tanır. Bağımsız dosyalar olarak daha fazla veya daha az simge boyutu dahil etmek için bu seçenek all veya none olarak ayarlanabilir.
--target-device cihaz-adı Derleme yapılacak hedef cihazı belirtir ve birden fazla kez geçilebilir. Bu seçenek uyarıları, doğrulamayı ve oluşturulan ürüne hangi görsellerin dahil edileceğini etkiler.
--compress-pngs iOS hedeflerine kopyalanan PNG'ler, iOS cihazlarında görsellerin okunmasını optimize etmek için pngcrush kullanılarak işlenecektir. Bu, yalnızca çıktı paketine kopyalanan PNG görsellerini etkilediğinden, derlenmiş CAR dosyasında yer alan görseller üzerinde hiçbir etkiye sahip değildir.
--filter-for-device-model cihaz actool'un CAR dosyasına konan dosyaları cihaza göre filtrelemesini sağlar. Bu, App Store'un geliştiricinin uygulamasını nasıl seyreltip küçülteceğini (thinning) simüle eder. Örneğin, iPhone9,1 değerini geçerseniz, actool yalnızca iPhone 7'ye uygun görselleri dahil edecektir. Bu, seyreltilmiş uygulamaların düzgün çalışacağından emin olmak amacıyla test yapmak için kullanışlıdır. Yapılandırma süresince bu işlem TARGET_DEVICE_MODEL yapılandırma ayarı tarafından yönlendirilir ve şema açılır menüsünde etkin çalışma hedefi seçilerek belirlenir. Bu argüman mevcut olmadığında, seyreltme gerçekleşmeyecektir.
--filter-for-device-os-version işletim_sistemi_sürümü actool'un CAR dosyasına konan dosyaları işletim sistemi sürümüne göre filtrelemesini sağlar. Bu, App Store'un, uygulamanın nihai hedef işletim sistemine bağlı olarak geliştiricinin uygulamasını nasıl seyreltip küçülteceğini simüle eder. Örneğin, iOS 11.0 sürümünü belirtmek için /fI11.0/fR (veya ilgili formatı) geçerseniz, actool yalnızca iOS 11.0'a uygun görselleri dahil edecek, ancak önceki sürümleri dahil etmeyecektir. Bu, seyreltilmiş uygulamaların düzgün çalışacağından emin olmak amacıyla test yapmak için kullanışlıdır.
Sticker Paketleri: --include-sticker-content Girdi varlık kataloglarından sticker paketi içeriğini dahil eder.
--stickers-icon-role rol Mesajlar (Messages) tarzı bir uygulama simgesi kullanırken hedef için uygun simge boyutlarını seçmek üzere app-host veya extension değerini geçin.
--sticker-pack-identifier-prefix önek Sticker yolunuzu tanımlamak için kullanılan varsayılan öneki ayarlar. Bu, geçerli bir alan adı türü tanımlayıcısı olmalıdır. Örneğin: com.mycompany.
--sticker-pack-strings-file dizgi_dosyası Sticker adlarını yerelleştirilmiş çevirilere eşleyen bir dizgi (strings) dosyası belirtir.
--product-type ürün-türü Kullanımdan kaldırılmıştır; bunun yerine --include-sticker-content ve --stickers-icon-role seçeneklerini kullanın.
Oluşturulan ürünün türünü ayarlar. Xcode'da tüm hedeflerin bir ürün türü vardır ve belirli ürün türleri actool içinde biraz farklı davranışlara neden olur. Bu davranışlar şu anda sticker'ların içeriklerini nasıl ürettiğine odaklanmıştır, çünkü sticker paketlerinin içeriğin nerede ve nasıl biçimlendirileceğine dair özel gereksinimleri vardır. actool şu anda iki özel ürün türünü tanır: com.apple.product-type.app-extension.messages-sticker-pack and com.apple.product-type.app-extension.messages.
İsteğe Bağlı Kaynaklar (On Demand Resources - ODR): --enable-on-demand-resources actool'a isteğe bağlı kaynakları işlemesini söyler. Bu, birden fazla CAR dosyasının üretilmesiyle sonuçlanabilir. Bu seçenek olmadan actool, varlık kataloğunda bulunan ODR etiketlerini yoksayar.
--asset-pack-output-specifications dosya_adı actool'a varlık kataloğunda bulunan ODR kaynakları hakkındaki bilgileri nereye yazacağını söyler. Çıkarılan dosya bir plist olacaktır.
İçeriği Listeleme: --print-contents Kataloğun içeriğinin bir listesini çıktıya dahil eder.
Sürüm Bilgisi: --version actool sürümünü yazdırır. Sürüm bilgisi, com.apple.actool.version anahtarı altında, bundle-version ve short-bundle-version alt anahtarlarıyla çıktı olarak verilir.
Examples
actool --compile /tmp MyApp.xcassets
actool, MyApp.xcassets kataloğunu derleyecek ve /tmp/Assets.car dosyasını üretecektir.
See Also
plist(1)
Apple Inc. Mar 9 2018 actool(1)