Jetpack Compose, kullanıcı arayüzü tasarım zamanı araçlarını doğrudan Kotlin'de işlerken tools: ad alanı, proje düzeyindeki yapılandırmalar için hâlâ gereklidir. Standart
AndroidManifest.xml ve res/raw/keep.xml gibi Android XML dosyaları, Lint uyarılarını yönetmek ve kaynak küçültücüyü yapılandırmak için tools: özelliklerini kullanır.
Uygulamanızı derlediğinizde derleme araçları bu özellikleri kaldırır. Böylece APK boyutunuz veya çalışma zamanı davranışınız etkilenmez.
Bu özellikleri kullanmak için tools ad alanını, kullanmak istediğiniz her XML dosyasının kök öğesine burada gösterildiği gibi ekleyin:
<RootTag xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" >
Hata işleme özellikleri
Aşağıdaki özellikler, lint uyarı mesajlarını engellemeye yardımcı olur:
tools:ignore
Kullanım amacı: Herhangi bir öğe
Kullanan: Lint
Bu özellik, araçların bu öğede veya alt öğelerinde yoksaymasını istediğiniz lint sorunu kimliklerinin virgülle ayrılmış listesini kabul eder.
Örneğin, araçlara MissingTranslation hatasını yoksaymasını söyleyebilirsiniz:
<string name="show_all_apps" tools:ignore="MissingTranslation">All</string>
tools:targetApi
Kullanım amacı: Herhangi bir öğe
Kullanan: Lint
Bu özellik, Java kodundaki @TargetApi ek açıklaması veya Kotlin kodundaki @RequiresApi ek açıklamasıyla aynı şekilde çalışır. Bu öğeyi destekleyen API düzeyini (tam sayı veya kod adı olarak) belirtmenize olanak tanır.
Bu, lint araçlarına bu öğenin ve tüm alt öğelerin yalnızca belirtilen API düzeyinde veya daha yüksek bir düzeyde kullanıldığını düşündüğünüzü bildirir. Bu sayede lint, minSdkVersion olarak belirttiğiniz API düzeyinde ilgili öğe veya özellikleri kullanılamıyorsa sizi uyarmaz.
Örneğin, AndroidManifest.xml dosyanızda yalnızca API düzeyi 34 ve sonraki sürümlerde kullanılabilen bir ön plan hizmeti türü kullanan bir <service> beyan ettiğiniz için bu özelliği kullanabilirsiniz ancak projenizin minSdkVersion değeri daha düşüktür:
<service
android:name=".playback.MediaPlaybackService"
android:foregroundServiceType="mediaPlayback"
xmlns:tools="http://schemas.android.com/tools"
tools:targetApi="34" />
tools:locale
Hedef kitle: <resources>
Kullananlar: Lint, Android Studio düzenleyicisi
Bu, araçlara, yazım denetleyiciden uyarı almamak için belirli <resources> öğesindeki kaynakların varsayılan dilinin veya yerel ayarının ne olduğunu bildirir.
Aksi takdirde araç, dilin İngilizce olduğunu varsayar.
Değer, geçerli bir yerel ayar niteleyici olmalıdır.
Örneğin, varsayılan dizeler için kullanılan dilin İngilizce yerine İspanyolca olduğunu belirtmek için bunu varsayılan values/strings.xml dosyanıza ekleyebilirsiniz:
<resources xmlns:tools="http://schemas.android.com/tools"
tools:locale="es">
Kaynak küçültme özellikleri
Aşağıdaki özellikler, katı referans kontrollerini etkinleştirmenize ve kaynak daraltma özelliğini kullanırken belirli kaynakları saklayıp saklamayacağınızı belirtmenize olanak tanır.
Kaynak daraltmayı etkinleştirmek için build.gradle dosyanızda shrinkResources özelliğini true olarak ayarlayın ve kod daraltma için minifyEnabled özelliğini kullanın.
Örneğin:
Modern
android { ... buildTypes { release { shrinkResources true minifyEnabled true proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } }
Kotlin
android { ... buildTypes { getByName("release") { isShrinkResources = true isMinifyEnabled = true proguardFiles( getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro" ) } } }
tools:shrinkMode
Hedef kitle: <resources>
Kullanım alanı: Kaynak daraltma özelliğine sahip derleme araçları
Bu özellik, derleme araçlarının aşağıdakileri kullanıp kullanmayacağını belirtmenize olanak tanır:
- Güvenli mod: Açıkça belirtilen ve
Resources.getIdentifierçağrısıyla dinamik olarak referans verilebilecek tüm kaynakları saklayın. - Yüksek düzey modu: Yalnızca kodda veya diğer kaynaklarda açıkça belirtilen kaynakları saklayın.
Varsayılan olarak güvenli mod (shrinkMode="safe") kullanılır. Bunun yerine yüksek düzey modu kullanmak için <resources> etiketine shrinkMode="strict" ekleyin:
<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
tools:shrinkMode="strict" />
Yüksek düzey modunu etkinleştirdiğinizde, kaldırılan ancak aslında istediğiniz kaynakları korumak için tools:keep, daha fazla kaynağı açıkça kaldırmak için ise tools:discard kullanmanız gerekebilir.
Daha fazla bilgi için Kaynaklarınızı küçültme başlıklı makaleyi inceleyin.
tools:keep
Hedef kitle: <resources>
Kullanım alanı: Kaynak daraltma özelliğine sahip derleme araçları
Kullanılmayan kaynakları kaldırmak için kaynak küçültme özelliğini kullanırken bu özellik, genellikle çalışma zamanında dolaylı bir şekilde referans verildiği için (ör. dinamik olarak oluşturulan bir kaynak adını Resources.getIdentifier'e ileterek) tutulacak kaynakları belirtmenize olanak tanır.
Bu özelliği kullanmak için kaynak dizininizde (ör. res/raw/keep.xml) <resources> etiketine sahip bir XML dosyası oluşturun ve tutulacak her kaynağı tools:keep özelliğinde virgülle ayrılmış liste olarak belirtin. Yıldız karakterini joker karakter olarak kullanabilirsiniz.
Örneğin:
<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
tools:keep="@layout/used_1,@layout/used_2,@layout/*_3" />
Daha fazla bilgi için Kaynaklarınızı küçültme başlıklı makaleyi inceleyin.
tools:discard
Hedef kitle: <resources>
Kullanım alanı: Kaynak daraltma özelliğine sahip derleme araçları
Kullanılmayan kaynakları kaldırmak için kaynak küçültme özelliğini kullanırken bu özellik, manuel olarak silmek istediğiniz kaynakları belirtmenize olanak tanır. Bu durum genellikle kaynağa referans verildiği ancak uygulamanızı etkilemeyecek şekilde referans verildiği veya Gradle eklentisinin kaynağa referans verildiğini yanlış bir şekilde çıkardığı için ortaya çıkar.
Bu özelliği kullanmak için kaynak dizininizde (ör. res/raw/keep.xml) <resources> etiketi içeren bir XML dosyası oluşturun ve tools:discard özelliğinde, silinecek her kaynağı virgülle ayrılmış bir liste olarak belirtin. Yıldız karakterini joker karakter olarak kullanabilirsiniz.
Örneğin:
<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
tools:discard="@layout/unused_1" />
Daha fazla bilgi için Kaynaklarınızı küçültme başlıklı makaleyi inceleyin.