Araç özelikleri referansı

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.

Ek kaynaklar

İçerik görüntüleme