Android Kuralları

Kurallar

android_binary

Kural kaynağını görüntüleme
android_binary(name, deps, srcs, assets, assets_dir, compatible_with, crunch_png, custom_package, debug_key, debug_signing_keys, debug_signing_lineage_file, densities, deprecation, dex_shards, dexopts, distribs, enable_data_binding, exec_compatible_with, exec_properties, features, incremental_dexing, instruments, javacopts, key_rotation_min_sdk, licenses, main_dex_list, main_dex_list_opts, main_dex_proguard_specs, manifest, manifest_values, multidex, nocompress_extensions, package_id, plugins, proguard_apply_dictionary, proguard_apply_mapping, proguard_generate_mapping, proguard_specs, resource_configuration_filters, resource_files, restricted_to, shrink_resources, tags, target_compatible_with, testonly, visibility)

Android uygulama paketi dosyaları (.apk) oluşturur.

Dolaylı çıkış hedefleri

  • name.apk: Hata ayıklama anahtarlarıyla imzalanmış ve zipalign uygulanmış bir Android uygulama paketi dosyası. Bu dosya, uygulamanızı geliştirmek ve hata ayıklamak için kullanılabilir. Uygulamanızı hata ayıklama anahtarlarıyla imzaladığınızda yayınlayamazsınız.
  • name_unsigned.apk: Yukarıdaki dosyanın, herkese açık olarak yayınlanmadan önce sürüm anahtarlarıyla imzalanabilen imzasız sürümü.
  • name_deploy.jar: Bu hedefin geçişli kapatmasını içeren bir Java arşivi.

    Dağıtım jar'ı, bu hedefin çalışma zamanı sınıf yolunu baştan sona arayan bir sınıf yükleyici tarafından bulunacak tüm sınıfları içerir.

  • name_proguard.jar: name_deploy.jar üzerinde ProGuard çalıştırmanın sonucunu içeren bir Java arşivi. Bu çıkış yalnızca proguard_specs özelliği belirtilmişse oluşturulur.
  • name_proguard.map: name_deploy.jar üzerinde ProGuard'ın çalıştırılmasıyla elde edilen bir eşleme dosyası sonucu. Bu çıkış yalnızca proguard_specs özelliği belirtilmişse ve proguard_generate_mapping veya shrink_resources ayarlanmışsa oluşturulur.

Örnekler

Android kuralı örneklerini, Bazel kaynak ağacının examples/android dizininde bulabilirsiniz.

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.

deps

Etiketler listesi; varsayılan değer []'dir.

İkili hedefe bağlanacak diğer kitaplıkların listesi. İzin verilen kitaplık türleri: android_library, java_library android kısıtlaması ile ve cc_library Android hedef platform için .so yerel kitaplıklarını sarmalayan veya üreten.
srcs

Etiket listesi; varsayılan []

Hedefi oluşturmak için işlenen kaynak dosyaların listesi.

.java türündeki srcs dosyaları derlendi. Okunabilirlik açısından, oluşturulmuş bir .java kaynak dosyasının adının srcs içine yerleştirilmesi uygun değildir. Bunun yerine, bağımlı kuralı adını aşağıda açıklandığı gibi srcs içine yerleştirin.

.srcjar türündeki srcs dosyaları paketten çıkarılır ve derlenir. (Bu, bir genrule veya derleme uzantısına sahip .Java dosyaları kümesi oluşturmanız gerekirse yararlı olur.)

assets

Etiket listesi; varsayılan []

Paketlenecek öğelerin listesi. Bu, genellikle assets dizini altındaki tüm dosyalar için glob değerindedir. Ayrıca, tüm dosyalar ilgili paketteki assets_dir dizininde olduğu sürece diğer paketlerdeki diğer kurallara (dosya oluşturan tüm kurallar) veya dışa aktarılan dosyalara da referans verebilirsiniz.
assets_dir

Dize; varsayılan değer ""'tir

assets içindeki dosyaların yolunu belirten dize. assets ve assets_dir çifti, paketlenmiş öğeleri tanımlar ve her iki özellik de sağlanmalı veya hiçbiri sağlanmamalıdır.
crunch_png

Boole; varsayılan değer True'tir

PNG sıkıştırma işlemi yapın (veya yapmayın). Bu, her zaman yapılan dokuz parçaya bölme işleminden bağımsızdır. Bu, aapt2'de düzeltilmiş bir aapt hatası için desteği sonlandırılmış geçici çözümdür.
custom_package

Dize; varsayılan değer ""'tir

Java kaynaklarının oluşturulacağı Java paketi. Varsayılan olarak paket, kuralı içeren BUILD dosyasının bulunduğu dizinden belirlenir. Farklı bir paket belirtebilirsiniz ancak bu yöntem, yalnızca çalışma zamanında algılanacak diğer kitaplıklarla sınıf yolu çakışmalarına neden olabileceğinden kesinlikle önerilmez.
debug_key

Etiket; varsayılan değer "@bazel_tools//tools/android:debug_keystore"

Hata ayıklama apk'sini imzalamak için kullanılacak hata ayıklama anahtar deposunu içeren dosya. Genellikle varsayılan anahtar dışında bir anahtar kullanmak istemezsiniz. Bu nedenle bu özellik atlanmalıdır.

UYARI: Üretim anahtarlarınızı kullanmayın, bunlar sıkı bir şekilde korunmalı ve kaynak ağacınızda tutulmamalıdır.

debug_signing_keys

Etiketler listesi; varsayılan değer []'dir.

Hata ayıklama APK'sını imzalamak için kullanılacak dosyaların, hata ayıklama anahtar depolarının listesi. Genellikle varsayılan anahtar dışında anahtar kullanmak istemezsiniz. Bu nedenle bu özellik atlanmalıdır.

UYARI: Üretim anahtarlarınızı kullanmayın. Bu anahtarlar kesinlikle korunmalı ve kaynak ağacınızda tutulmamalıdır.

debug_signing_lineage_file

Etiket; varsayılan değer None

error_signing_keys için imzalama sırasını içeren dosya. Genellikle varsayılan anahtar dışında anahtar kullanmak istemezsiniz. Bu nedenle bu özellik atlanmalıdır.

UYARI: Üretim anahtarlarınızı kullanmayın. Bu anahtarlar kesinlikle korunmalı ve kaynak ağacınızda tutulmamalıdır.

densities

Dize listesi; varsayılan değer []'tir.

APK oluşturulurken filtrelenecek yoğunluklar. Bu işlem, APK boyutunu azaltmak için belirtilen ekran yoğunluklarına sahip bir cihaz tarafından yüklenmeyecek olan kafes çekilebilir kaynakları ortadan kaldırır. İlgili uyumlu ekranlar bölümü de üst küme girişi içermiyorsa manifeste eklenir.
dex_shards

Tam sayı; varsayılan değer 1

Dizine eklenecek parça sayısı. Bu, uygulama yükleme ve başlatma süresi pahasına dexing işlemini çok daha hızlı hale getirir. İkili dosya ne kadar büyükse o kadar fazla parça kullanılmalıdır. 25, deneme yapmaya başlamak için iyi bir değerdir.

Her kırığın son uygulamada en az bir dex olacağını unutmayın. Bu nedenle, yayın ikili programları için bu değerin 1'den yüksek bir değere ayarlanması önerilmez.

dexopts

Dize listesi; varsayılan değer []'tir.

classes.dex dosyası oluşturulurken dx aracı için ek komut satırı işaretleri. "Değişken oluşturma" değişikliğine ve Bourne kabuk belirtkelemeye tabidir.
enable_data_binding

Boole; varsayılan değer False

Doğru değerine ayarlanırsa bu kural, resource_files özelliği aracılığıyla eklenen düzen kaynaklarındaki veri bağlama ifadelerini işler. Bu ayar olmadan veri bağlama ifadeleri derleme hatalarına neden olur.

Veri bağlama ile Android uygulaması oluşturmak için aşağıdakileri de yapmanız gerekir:

  1. Geçişli olarak buna bağlı tüm Android kuralları için bu özelliği ayarlayın. Bunun nedeni, bağımlıların kaynak birleştirme yoluyla kuralın veri bağlama ifadelerini devralmasıdır. Dolayısıyla, bu ifadeleri ayrıştırmak için veri bağlama ile derlemeleri de gerekir.
  2. Bu özelliği ayarlayan tüm hedeflere, veri bağlama çalışma zamanı kitaplığı için bir deps = girişi ekleyin. Bu kitaplığın konumu, depo kurulumunuza bağlıdır.
incremental_dexing

Tamsayı; yapılandırılamaz; varsayılan değer -1

Varsayılanları ve --incremental_dexing işaretini geçersiz kılarak hedefin artımlı dizine ekleme ile veya olmadan derlenmesini zorunlu kılar.
instruments

Etiket; varsayılan değer None

android_binary aracı hedefi.

Bu özellik ayarlanırsa bu android_binary, araç testleri için bir test uygulaması olarak değerlendirilir. Daha sonra bir android_instrumentation_test hedefi, bu hedefi test_app özelliğinde belirtebilir.

javacopts

Dize listesi; varsayılan değer: []

Bu hedef için ek derleyici seçenekleri. "Değişken oluşturma" değişikliğine ve Bourne kabuk belirtkelemeye tabidir.

Bu derleyici seçenekleri, genel derleyici seçeneklerinden sonra javac'a iletilir.

key_rotation_min_sdk

Dize; varsayılan değer ""'tir

APK'nın imzasını oluşturmak için APK'nın dönüşümlü imzalama anahtarının kullanılması gereken minimum Android platform sürümünü (API Düzeyi) belirler. APK'nın orijinal imzalama anahtarı, önceki tüm platform sürümleri için kullanılır.
main_dex_list

Etiket; varsayılan değer None'dir.

Sınıf dosya adlarının listesini içeren bir metin dosyası. Bu sınıf dosyalarıyla tanımlanan sınıflar birincil classes.dex dosyasına yerleştirilir. Örneğin:
          android/support/multidex/MultiDex$V19.class
          android/support/multidex/MultiDex.class
          android/support/multidex/MultiDexApplication.class
          com/google/common/base/Objects.class
                    
multidex="manual_main_dex" ile kullanılmalıdır.
main_dex_list_opts

Dize listesi; varsayılan değer: []

Ana dex listesi oluşturucuya iletilecek komut satırı seçenekleri. Ana dex listesine dahil edilen sınıfları etkilemek için bu seçeneği kullanın.
main_dex_proguard_specs

Etiketler listesi; varsayılan değer []'dir.

Ana dex'te tutulması gereken sınıfları belirlemek için ProGuard spesifikasyonları olarak kullanılacak dosyalar. Yalnızca multidex özelliği legacy olarak ayarlandıysa izin verilir.
manifest

Etiket; zorunlu

Android manifest dosyasının adı (normalde AndroidManifest.xml olur). resource_files veya assets tanımlanırsa tanımlanmalıdır.
manifest_values

Sözlük: Dize -> Dize; varsayılan {}

Manifest'te geçersiz kılınacak değerler sözlüğü.

Manifest'teki tüm ${name} örnekleri, bu sözlükteki ada karşılık gelen değerle değiştirilir.

applicationId, versionCode, versionName, minSdkVersion, targetSdkVersion ve maxSdkVersion de manifest ve uses-sdk etiketlerindeki karşılık gelen özellikleri geçersiz kılar.

packageName yoksayılır ve belirtilirse applicationId veya manifestteki paketten ayarlanır.

manifest_merger, legacy olarak ayarlandığında yalnızca applicationId, versionCode ve versionName etkili olur.

multidex

Dize; varsayılan değer "native"'tir

Kodun birden fazla dex dosyasına bölünüp bölünmeyeceği.
Olası değerler:
  • native: DEX 64K dizin sınırı aşıldığında kodu birden fazla DEX dosyasına bölün. Çoklu dex sınıflarının çalışma zamanında yüklenmesi için doğal platform desteğinin var olduğu varsayılır. Bu yöntem yalnızca Android L ve sonraki sürümlerde çalışır.
  • legacy: Dex 64K dizin sınırı aşıldığında kodu birden fazla dex dosyasına bölebilirsiniz. Multidex sınıflarının uygulama kodu aracılığıyla yüklendiği varsayılır (ör. doğal platform desteği yoktur).
  • manual_main_dex: DEX 64K dizin sınırı aşıldığında kodu birden fazla DEX dosyasına bölün. Ana dex dosyasının içeriğinin, main_dex_list özelliği kullanılarak bir metin dosyasında sınıfların listesi sağlanarak belirtilmesi gerekir.
  • off: Dizin sınırını aşsa bile tüm kodu tek bir dex dosyasında derleyin.
nocompress_extensions

Dize listesi; varsayılan değer: []

APK'da sıkıştırılmadan bırakılacak dosya uzantılarının listesi.
package_id

Tam sayı; varsayılan değer 0'tür

Bu ikili dosyasındaki kaynaklara atanacak paket kimliği.

Daha fazla bilgi için AAPT2'nin --package-id bağımsız değişkenini inceleyin. Bu genellikle ayarlanmamış bırakılabilir (ve bırakılmalıdır). Bu durumda varsayılan değer 127 olur (0x7F).

plugins

Etiketler listesi; varsayılan değer []'dir.

Derleme zamanında çalışacak Java derleyici eklentileri. Eklentiler özelliğinde belirtilen her java_plugin, bu hedef oluşturulduğunda çalışır. Eklenti tarafından oluşturulan kaynaklar, hedefin sonuç jar dosyasına dahil edilir.
proguard_apply_dictionary

Etiket; varsayılan değer None

Proguard için eşleme olarak kullanılacak dosya. Kod karartma sırasında sınıfları ve üyeleri yeniden adlandırırken çıkarılacak "kelimeleri" içeren, satırla ayrılmış bir dosya.
proguard_apply_mapping

Etiket; varsayılan değer None

Proguard için eşleme olarak kullanılacak dosya. proguard_generate_mapping tarafından oluşturulan eşleme dosyası, aynı eşlemeyi yeni bir derlemeye uygulamak için yeniden kullanılacak.
proguard_generate_mapping

Boole; yapılandırılmamış; varsayılan değer False

ProGuard eşleme dosyasının oluşturulup oluşturulmayacağı. Eşleme dosyası yalnızca proguard_specs belirtilmişse oluşturulur. Bu dosya orijinal ile kodu karartılmış sınıf, yöntem ve alan adları arasındaki eşlemeyi listeler.

UYARI: Bu özellik kullanılıyorsa ProGuard spesifikasyonu -dontobfuscate veya -printmapping içermemelidir.

proguard_specs

Etiketler listesi; varsayılan değer []'dir.

ProGuard spesifikasyonu olarak kullanılacak dosyalar. Bu dosyada, Proguard tarafından kullanılacak özellik grubu açıklanır.
resource_configuration_filters

Dize listesi; varsayılan değer: []

Apk'daki kaynakları yalnızca "en" yapılandırmasında olanlarla sınırlayacak "en" gibi kaynak yapılandırma filtrelerinin listesi. Sözde yerelleştirmeyi etkinleştirmek için en_XA ve/veya ar_XB sözde yerel ayarlarını ekleyin.
resource_files

Etiket listesi; varsayılan []

Paketlenecek kaynakların listesi. Bu, genellikle res dizini altındaki tüm dosyalar için glob değerindedir.
Oluşturulan dosyalar (genrules'den) buradaki Etiket ile de referans verilebilir. Tek kısıtlama, oluşturulan çıkışların, dahil edilen diğer tüm kaynak dosyalarıyla aynı "res" dizininde olması gerektiğidir.
shrink_resources

Tam sayı; varsayılan değer -1'tür

Kaynak daraltma işleminin yapılıp yapılmayacağı. İkili program tarafından kullanılmayan kaynaklar APK'dan kaldırılır. Bu, yalnızca yerel kaynakları (ör. manifest ve resource_files özellikleri) kullanan kurallar için desteklenir ve ProGuard gerektirir. Gradle kaynak daraltıcı ile büyük ölçüde aynı şekilde çalışır (https://developer.android.com/studio/build/shrink-code.html#shrink-resources).

Önemli farklılıklar:

  • values/'teki kaynaklar ve dosya tabanlı kaynaklar da kaldırılır.
  • varsayılan olarak strict mode değerini kullanır
  • Kullanılmayan kimlik kaynaklarının kaldırılması yalnızca aapt2 ile desteklenir.
Kaynak küçültme etkinse gerçekleştirilen analiz ve silme işlemlerinin ayrıntılarını içeren name_files/resource_shrinker.log da oluşturulur.

Olası değerler:

  • shrink_resources = 1: Android kaynak küçültme özelliğini etkinleştirir.
  • shrink_resources = 0: Android kaynak küçültme özelliğini devre dışı bırakır.
  • shrink_resources = -1: Daraltma, --android_resource_shrinking işareti ile kontrol edilir.

aar_import

Kural kaynağını göster
aar_import(name, deps, data, aar, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, exports, features, licenses, restricted_to, srcjar, tags, target_compatible_with, testonly, visibility)

Bu kural, android_library ve android_binary kuralları için .aar dosyalarının kitaplık olarak kullanılmasına olanak tanır.

Örnekler

    aar_import(
        name = "google-vr-sdk",
        aar = "gvr-android-sdk/libraries/sdk-common-1.10.0.aar",
    )

    android_binary(
        name = "app",
        manifest = "AndroidManifest.xml",
        srcs = glob(["**.java"]),
        deps = [":google-vr-sdk"],
    )

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.

aar

Etiket; zorunlu

Bu hedefe bağlı Android hedeflerine sağlanacak .aar dosyası.
exports

Etiketler listesi; varsayılan değer []'dir.

Bu kurala bağlı olan kurallara aktarılacak hedefler. Bkz. java_library.exports.
srcjar

Etiket; varsayılan değer None'dir.

AAR'daki derlenmiş JAR dosyalarının kaynak kodunu içeren bir JAR dosyası.

android_library

Kural kaynağını görüntüleme
android_library(name, deps, srcs, data, assets, assets_dir, compatible_with, custom_package, deprecation, distribs, enable_data_binding, exec_compatible_with, exec_properties, exported_plugins, exports, exports_manifest, features, idl_import_root, idl_parcelables, idl_preprocessed, idl_srcs, javacopts, licenses, manifest, neverlink, plugins, proguard_specs, resource_files, restricted_to, tags, target_compatible_with, testonly, visibility)

Bu kural, kaynaklarını bir .jar dosyasında derler ve arşivler. Android çalışma zamanı kitaplığı android.jar, derleme sınıf yoluna dolaylı olarak yerleştirilir.

Dolaylı çıkış hedefleri

  • libname.jar: Bir Java arşivi.
  • libname-src.jar: Kaynakları içeren bir arşiv ("kaynak jar").
  • name.aar: Bu hedefin java arşivini ve kaynaklarını içeren bir Android "aar" paketi. Geçişli kapatma içermez.

Örnekler

Android kuralı örneklerini, Bazel kaynak ağacının examples/android dizininde bulabilirsiniz.

Aşağıdaki örnekte idl_import_root öğesinin nasıl ayarlanacağı gösterilmektedir. //java/bazel/helloandroid/BUILD şunları içeriyor:

android_library(
    name = "parcelable",
    srcs = ["MyParcelable.java"], # bazel.helloandroid.MyParcelable

    # MyParcelable.aidl will be used as import for other .aidl
    # files that depend on it, but will not be compiled.
    idl_parcelables = ["MyParcelable.aidl"] # bazel.helloandroid.MyParcelable

    # We don't need to specify idl_import_root since the aidl file
    # which declares bazel.helloandroid.MyParcelable
    # is present at java/bazel/helloandroid/MyParcelable.aidl
    # underneath a java root (java/).
)

android_library(
    name = "foreign_parcelable",
    srcs = ["src/android/helloandroid/OtherParcelable.java"], # android.helloandroid.OtherParcelable
    idl_parcelables = [
        "src/android/helloandroid/OtherParcelable.aidl" # android.helloandroid.OtherParcelable
    ],

    # We need to specify idl_import_root because the aidl file which
    # declares android.helloandroid.OtherParcelable is not positioned
    # at android/helloandroid/OtherParcelable.aidl under a normal java root.
    # Setting idl_import_root to "src" in //java/bazel/helloandroid
    # adds java/bazel/helloandroid/src to the list of roots
    # the aidl compiler will search for imported types.
    idl_import_root = "src",
)

# Here, OtherInterface.aidl has an "import android.helloandroid.CallbackInterface;" statement.
android_library(
    name = "foreign_interface",
    idl_srcs = [
        "src/android/helloandroid/OtherInterface.aidl" # android.helloandroid.OtherInterface
        "src/android/helloandroid/CallbackInterface.aidl" # android.helloandroid.CallbackInterface
    ],

    # As above, idl_srcs which are not correctly positioned under a java root
    # must have idl_import_root set. Otherwise, OtherInterface (or any other
    # interface in a library which depends on this one) will not be able
    # to find CallbackInterface when it is imported.
    idl_import_root = "src",
)

# MyParcelable.aidl is imported by MyInterface.aidl, so the generated
# MyInterface.java requires MyParcelable.class at compile time.
# Depending on :parcelable ensures that aidl compilation of MyInterface.aidl
# specifies the correct import roots and can access MyParcelable.aidl, and
# makes MyParcelable.class available to Java compilation of MyInterface.java
# as usual.
android_library(
    name = "idl",
    idl_srcs = ["MyInterface.aidl"],
    deps = [":parcelable"],
)

# Here, ServiceParcelable uses and thus depends on ParcelableService,
# when it's compiled, but ParcelableService also uses ServiceParcelable,
# which creates a circular dependency.
# As a result, these files must be compiled together, in the same android_library.
android_library(
    name = "circular_dependencies",
    srcs = ["ServiceParcelable.java"],
    idl_srcs = ["ParcelableService.aidl"],
    idl_parcelables = ["ServiceParcelable.aidl"],
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.

deps

Etiket listesi; varsayılan []

Bağlantı kurulacak diğer kitaplıkların listesi. İzin verilen kitaplık türleri: android_library, java_library android kısıtlaması ile ve cc_library Android hedef platformu için .so yerel kitaplıklarını sarmalayan veya üreten.
srcs

Etiket listesi; varsayılan []

Hedefi oluşturmak için işlenen .java veya .srcjar dosyalarının listesi.

.java türündeki srcs dosyaları derlendi. Okunabilirlik açısından, oluşturulan .java kaynak dosyasının adını srcs içine yerleştirmek iyi bir fikir değildir. Bunun yerine, bağımlı kuralı adını aşağıda açıklandığı gibi srcs içine yerleştirin.

.srcjar türündeki srcs dosyaları paketten çıkarılır ve derlenir. (Bu, bir genrule veya derleme uzantısına sahip .Java dosyaları kümesi oluşturmanız gerekirse yararlı olur.)

srcs atlanırsa deps politikasında belirtilen tüm bağımlılıklar bu kuraldan dışa aktarılır (bağımlılıkları dışa aktarma hakkında daha fazla bilgi için Java_library'nin dışa aktarma işlemlerine bakın). Ancak bu davranış yakında kullanımdan kaldırılacağı için bu yaklaşıma güvenmemeye çalışın.

assets

Etiketler listesi; varsayılan değer []'dir.

Paketlenecek öğelerin listesi. Bu, genellikle assets dizini altındaki tüm dosyalar için glob değerindedir. Ayrıca, tüm bu dosyalar ilgili pakette assets_dir dizini altında olduğu sürece, başka kurallara (dosya oluşturan tüm kurallar) başvurabilir ya da diğer paketlerdeki dosyaları dışa aktarabilirsiniz.
assets_dir

Dize; varsayılan değer ""'tir

assets klasöründeki dosyaların yolunu veren dize. assets ve assets_dir çifti, paketlenmiş öğeleri tanımlar ve her iki özellik de sağlanmalı veya hiçbiri sağlanmamalıdır.
custom_package

Dize; varsayılan değer ""'tir

Java kaynaklarının oluşturulacağı Java paketi. Varsayılan olarak paket, kuralı içeren BUILD dosyasının bulunduğu dizinden belirlenir. Farklı bir paket belirtebilirsiniz ancak bu yöntem, yalnızca çalışma zamanında algılanacak diğer kitaplıklarla sınıf yolu çakışmalarına neden olabileceğinden kesinlikle önerilmez.
enable_data_binding

Boole; varsayılan değer False'tir

Doğru değerine ayarlanırsa bu kural, resource_files özelliği aracılığıyla eklenen düzen kaynaklarındaki veri bağlama ifadelerini işler. Bu ayar kullanılmadığında, veri bağlama ifadeleri derleme hataları oluşturur.

Veri bağlama ile Android uygulaması oluşturmak için aşağıdakileri de yapmanız gerekir:

  1. Geçişli olarak buna bağlı tüm Android kuralları için bu özelliği ayarlayın. Bunun nedeni, bağımlıların kaynak birleştirme yoluyla kuralın veri bağlama ifadelerini devralmasıdır. Dolayısıyla, bu ifadeleri ayrıştırmak için veri bağlama ile derlemeleri de gerekir.
  2. Bu özelliği ayarlayan tüm hedeflere veri bağlama çalışma zamanındaki kitaplığı için bir deps = girişi ekleyin. Bu kitaplığın konumu, depo kurulumunuza bağlıdır.
exported_plugins

Etiket listesi; varsayılan []

Doğrudan bu kitaplığa bağlı kitaplıklara aktarılacak java_plugin'lerin (ör. ek açıklama işlemcileri) listesi.

Belirtilen java_plugin listesi, doğrudan bu kitaplığa bağlı olan tüm kitaplıklara, söz konusu kitaplık plugins'ta bu etiketleri açıkça tanımlamış gibi uygulanır.

exports

Etiketler listesi; varsayılan değer []'dir.

exports özellikleri aracılığıyla erişilen tüm kuralların kapatılması, exports ile hedefe doğrudan bağlı olan herhangi bir kuralın doğrudan bağımlılığı olarak kabul edilir.

exports, ait olduğu kuralın doğrudan noktası değil.

exports_manifest

Tam sayı; varsayılan değer 1

Manifest girişlerinin bu hedefe bağlı olan android_binary hedeflerine dışa aktarılıp aktarılmayacağı. uses-permissions özellikleri hiçbir zaman dışa aktarılmaz.
idl_import_root

Dize; varsayılan değer ""'tir

Bu kitaplığa dahil edilen idl kaynaklarını içeren java paket ağacının köküne göreli paket yolu.

Bu yol, bu kitaplığa bağlı boşl kaynakları işlenirken içe aktarma kökü olarak kullanılır.

idl_import_root belirtildiğinde hem idl_parcelables hem de idl_srcs, idl_import_root altında temsil ettikleri nesnenin Java paketi tarafından belirtilen yolda olmalıdır. idl_import_root belirtilmediğinde hem idl_parcelables hem de idl_srcs, Java kökü altında paketlerinin belirttiği yolda olmalıdır.

Örnekleri inceleyin.

idl_parcelables

Etiket listesi; varsayılan []

İçe aktarma olarak sağlanacak Android IDL tanımlarının listesi. Bu dosyalar, doğrudan veya geçişli kapatma aracılığıyla bu kitaplığa bağlı olan herhangi bir android_library hedefi için içe aktarma olarak kullanıma sunulur ancak Java'ya çevrilmez veya derlenmez.

Yalnızca bu kitaplıktaki .java kaynaklarına doğrudan karşılık gelen .aidl dosyaları dahil edilmelidir (ör. Parcelable'ın özel uygulamaları). Aksi takdirde idl_srcs kullanılmalıdır.

Bu dosyalar, aidl derleyicisinin bulabilmesi için uygun şekilde yerleştirilmelidir. Bunun ne anlama geldiği hakkında bilgi edinmek için idl_import_root açıklamasına bakın.

idl_preprocessed

Etiketler listesi; varsayılan değer []'dir.

İçe aktarma olarak sağlanacak önceden işlenmiş Android IDL tanımlarının listesi. Bu dosyalar, doğrudan veya geçişli kapatma aracılığıyla bu kitaplığa bağlı olan herhangi bir android_library hedefi için içe aktarma olarak kullanıma sunulur ancak Java'ya çevrilmez veya derlenmez.

Yalnızca bu kitaplıktaki .java kaynaklarına doğrudan karşılık gelen önceden işlenmiş .aidl dosyaları dahil edilmelidir (ör. Parcelable'ın özel uygulamaları), aksi takdirde Java arayüzlerine çevrilmesi gereken Android IDL tanımları için idl_srcs, ön işlenmemiş AIDL dosyaları için ise idl_parcelable kullanılır.

idl_srcs

Etiket listesi; varsayılan []

Java arayüzlerine çevrilecek Android IDL tanımlarının listesi. Java arayüzleri oluşturulduktan sonra srcs içeriğiyle birlikte derlenir.

Bu dosyalar, bu kitaplığa bağlı olan herhangi bir android_library hedefi için doğrudan veya geçişli kapatma aracılığıyla içe aktarma olarak kullanıma sunulacaktır.

Bu dosyalar, aidl derleyicisinin bulabilmesi için uygun şekilde yerleştirilmelidir. Bunun ne anlama geldiği hakkında bilgi edinmek için idl_import_root özelliğinin açıklamasına bakın.

javacopts

Dize listesi; varsayılan değer: []

Bu hedef için ek derleyici seçenekleri. "Değişken oluştur" yerine koyma işlemine ve Bourne kabuğu

Bu derleyici seçenekleri, genel derleyici seçeneklerinden sonra javac'ya iletilir.

manifest

Etiket; varsayılan değer None

Android manifest dosyasının adı (normal olarak AndroidManifest.xml). resource_files veya assets tanımlanmışsa tanımlanmalıdır.

Boole; varsayılan değer False

Bu kitaplığı yalnızca derleme için kullanın, çalışma zamanında kullanmayın. neverlink olarak işaretlenen bir kuralın çıkışları, .apk oluşturma işleminde kullanılmaz. Kitaplık, yürütme sırasında çalışma zamanı ortamı tarafından sağlanacaksa kullanışlıdır.
plugins

Etiket listesi; varsayılan []

Derleme zamanında çalışacak Java derleyici eklentileri. Eklentiler özelliğinde belirtilen her java_plugin, bu hedef oluşturulduğunda çalışır. Eklenti tarafından oluşturulan kaynaklar, hedefin sonuç jar'ına dahil edilir.
proguard_specs

Etiketler listesi; varsayılan değer []'dir.

Proguard spesifikasyonu olarak kullanılacak dosyalar. Bunlar, Proguard tarafından kullanılacak özellik grubunu açıklar. Belirtilirse bu kitaplığa bağlı olarak herhangi bir android_binary hedefine eklenir. Buraya dahil edilen dosyalarda yalnızca idempotent kurallar (ör. -dontnote, -dontwarn, assumenosideeffects ve -keep ile başlayan kurallar) bulunmalıdır. Diğer seçenekler, totoolojik olmayan birleştirmeleri sağlamak için yalnızca android_binary proGuard_specs içinde görünebilir.
resource_files

Etiketler listesi; varsayılan değer []'dir.

Paketlenecek kaynakların listesi. Bu, genellikle res dizini altındaki tüm dosyalar için glob değerindedir.
Oluşturulan dosyalara (genrules'tan) buradaki Etiket aracılığıyla da referans verilebilir. Tek kısıtlama, oluşturulan çıkışların, dahil edilen diğer tüm kaynak dosyalarıyla aynı "res" dizininde olmasıdır.

android_instrumentation_test

Kural kaynağını göster
android_instrumentation_test(name, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, licenses, local, restricted_to, shard_count, size, support_apks, tags, target_compatible_with, target_device, test_app, testonly, timeout, toolchains, visibility)

Bir android_instrumentation_test kuralı, Android araç testlerini çalıştırır. Bir emülatörü başlatır, test edilen uygulamayı, test uygulamasını ve diğer gerekli uygulamaları yükler, test paketinde tanımlanan testleri çalıştırır.

test_app özelliği, testi içeren android_binary değerini belirtir. Bu android_binary, instruments özelliği aracılığıyla test edilen android_binary uygulamasını belirtir.

Örnek

# java/com/samples/hello_world/BUILD

android_library(
    name = "hello_world_lib",
    srcs = ["Lib.java"],
    manifest = "LibraryManifest.xml",
    resource_files = glob(["res/**"]),
)

# The app under test
android_binary(
    name = "hello_world_app",
    manifest = "AndroidManifest.xml",
    deps = [":hello_world_lib"],
)
# javatests/com/samples/hello_world/BUILD

android_library(
    name = "hello_world_test_lib",
    srcs = ["Tests.java"],
    deps = [
      "//java/com/samples/hello_world:hello_world_lib",
      ...  # test dependencies such as Espresso and Mockito
    ],
)

# The test app
android_binary(
    name = "hello_world_test_app",
    instruments = "//java/com/samples/hello_world:hello_world_app",
    manifest = "AndroidManifest.xml",
    deps = [":hello_world_test_lib"],
)

android_instrumentation_test(
    name = "hello_world_uiinstrumentation_tests",
    target_device = ":some_target_device",
    test_app = ":hello_world_test_app",
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.

support_apks

Etiketler listesi; varsayılan değer []'dir.

Araç testi başlamadan önce cihaza yüklenecek diğer APK'lar.
target_device

Etiket; zorunlu

Testin çalıştırılması gereken android_device.

Testi, çalışan bir emülatörde veya fiziksel bir cihazda çalıştırmak için şu bağımsız değişkenleri kullanın: --test_output=streamed --test_arg=--device_broker_type=LOCAL_ADB_SERVER --test_arg=--device_serial_number=$device_identifier

test_app

Etiket; zorunlu

Test sınıflarını içeren android_binary hedefi. android_binary hedefi, instruments özelliği aracılığıyla hangi hedefi test ettiğini belirtmelidir.

android_local_test

Kural kaynağını görüntüleme
android_local_test(name, deps, srcs, data, args, compatible_with, custom_package, densities, deprecation, enable_data_binding, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, javacopts, jvm_flags, licenses, local, manifest, manifest_values, nocompress_extensions, plugins, resource_configuration_filters, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, shard_count, size, stamp, tags, target_compatible_with, test_class, testonly, timeout, toolchains, use_launcher, visibility)

Bu kural, android_library kurallarını yerel olarak (cihazda değil) test etmek içindir. Android Robolectric test çerçevesiyle çalışır. Robolectric testleri yazmayla ilgili ayrıntılar için Android Robolectric sitesine bakın.

Örtülü çıkış hedefleri

  • name.jar: Testin Java arşivi.
  • name-src.jar: Kaynakları içeren bir arşiv ("kaynak jar").
  • name_deploy.jar: Dağıtıma uygun bir Java dağıtım arşivi (yalnızca açıkça istenirse oluşturulur).

Örnekler

Robolectric'i android_local_test ile kullanmak için WORKSPACE dosyanıza Robolectric'in deposunu ekleyin:

http_archive(
    name = "robolectric",
    urls = ["https://github.com/robolectric/robolectric-bazel/archive/<COMMIT>.tar.gz"],
    strip_prefix = "robolectric-bazel-<COMMIT>",
    sha256 = "<HASH>",
)
load("@robolectric//bazel:robolectric.bzl", "robolectric_repositories")
robolectric_repositories()
Bu komut, Robolectric için gereken maven_jar kurallarını getirir. Ardından her android_local_test kuralı @robolectric//bazel:robolectric'a bağlı olmalıdır. Aşağıdaki örneğe bakın.

android_local_test(
    name = "SampleTest",
    srcs = [
        "SampleTest.java",
    ],
    manifest = "LibManifest.xml",
    deps = [
        ":sample_test_lib",
        "@robolectric//bazel:android-all",
    ],
)

android_library(
    name = "sample_test_lib",
    srcs = [
         "Lib.java",
    ],
    resource_files = glob(["res/**"]),
    manifest = "AndroidManifest.xml",
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.

deps

Etiketler listesi; varsayılan değer []'dir.

Test edilecek kitaplıkların yanı sıra hedefe bağlanacak ek kitaplıkların listesi. Bu özelliğin geçişli kapatılmasında Android kurallarında belirtilen tüm kaynaklar, öğeler ve manifest dosyaları testte kullanıma sunulmuştur.

deps içinde izin verilen kurallar listesi şunlardır: android_library, aar_import, java_import, java_library ve java_lite_proto_library.

srcs

Etiketler listesi; varsayılan değer []'dir.

Hedefi oluşturmak için işlenen kaynak dosyaların listesi. Aşağıda açıklanan özel durumlar dışında gereklidir.

.java türündeki srcs dosyaları derlendi. Okunabilirlik açısından, oluşturulan .java kaynak dosyasının adını srcs içine yerleştirmek iyi bir fikir değildir. Bunun yerine, aşağıda açıklandığı gibi srcs alanına bağlı kuralın adını girin.

.srcjar türündeki srcs dosyaları paketten çıkarılır ve derlenir. (Bu, bir genrule veya derleme uzantısına sahip .Java dosyaları kümesi oluşturmanız gerekirse yararlı olur.)

Yukarıda açıklanan dosya türünde en az bir dosya bulunduğu sürece diğer tüm dosyalar yoksayılır. Aksi takdirde bir hata meydana gelir.

srcs özelliği zorunludur ve runtime_deps belirtilmediği sürece boş bırakılamaz.

custom_package

Dize; varsayılan değer ""

R sınıfının oluşturulacağı Java paketi. Paket varsayılan olarak, kuralı içeren BUILD dosyasının bulunduğu dizinden inferred edilir. Bu özelliği kullanırsanız muhtemelen test_class özelliğini de kullanmanız gerekir.
densities

Dize listesi; varsayılan değer []'tir.

Apk oluşturulurken filtrelenecek yoğunluklar. Henüz bir üst küme StarlarkListing içermiyorsa manifest'e karşılık gelen bir compatible-screens bölümü de eklenir.
enable_data_binding

Boole; varsayılan değer False'tir

Doğru ise bu kural, bu test tarafından kullanılan veri bağlama özellikli bağımlılıklarda kullanılan veri bağlama referanslarını işler. Bu ayar kullanılmadığında, veri bağlama bağımlılıkları ikili düzeyde kod oluşturma işlemi gerçekleştirmez ve derleme hatalarına neden olabilir.
javacopts

Dize listesi; varsayılan değer: []

Bu kitaplık için ek derleyici seçenekleri. "Değişken oluştur" yerine koyma işlemine ve Bourne kabuğu

Bu derleyici seçenekleri, genel derleyici seçeneklerinden sonra javac'ya iletilir.

jvm_flags

Dize listesi; varsayılan değer []'tir.

Bu ikili dosyanın çalıştırılması için oluşturulan sarmalayıcı komut dosyasına yerleştirilecek işaretlerin listesi. $(location) ve "Değişken yap" değişikliği ile Bourne kabuk belirtkeleme'ye tabidir.

Java ikili dosyası için sarmalayıcı komut dosyası, CLASSPATH tanımı (tüm bağımlı jar dosyalarını bulmak için) içerir ve doğru Java yorumlayıcısını çağırır. Sarmalayıcı komut dosyası tarafından oluşturulan komut satırı, ana sınıfın adını ve ardından "$@" karakterini içerir. Böylece sınıf adından sonra diğer bağımsız değişkenleri iletebilirsiniz. Ancak JVM tarafından ayrıştırılmak istenen bağımsız değişkenler, komut satırında sınıf adından önce belirtilmelidir. jvm_flags içeriği, sınıf adı listelenmeden önce sarmalayıcı komut dosyasına eklenir.

Bu özelliğin *_deploy.jar çıkışları üzerinde etkisi olmadığını unutmayın.

manifest

Etiket; varsayılan değer None'dir.

Android manifest dosyasının adı (normalde AndroidManifest.xml olur). resource_files veya assets tanımlanmışsa ya da test edilen kütüphanelerdeki manifest dosyalarından herhangi birinde minSdkVersion etiketi varsa tanımlanmalıdır.
manifest_values

Sözlük: Dize -> Dize; varsayılan değer {}'tir

Manifest'te geçersiz kılınacak değerler sözlüğü. Manifest'teki tüm ${name} örnekleri, bu sözlükte name değerine karşılık gelen değerle değiştirilir. applicationId, versionCode, versionName, minSdkVersion, targetSdkVersion ve maxSdkVersion, manifest ve uses-sdk etiketlerinin ilgili özelliklerini de geçersiz kılar. packageName yoksayılır ve belirtilirse applicationId veya manifestteki paketten ayarlanır. manifest_values parametresini kullanmak için kuralda bir manifest dosyasının bulunması gerekmez.
nocompress_extensions

Dize listesi; varsayılan değer []'tir.

Kaynak apk'da sıkıştırılmadan bırakılacak dosya uzantılarının listesi.
plugins

Etiket listesi; varsayılan []

Derleme zamanında çalışacak Java derleyici eklentileri. Bu özellikte belirtilen her java_plugin, bu kural derlendiğinde çalıştırılır. Bir kitaplık, exported_plugins kullanan bağımlılıklardan eklentiler de devralabilir. Eklenti tarafından oluşturulan kaynaklar, bu kuralın ortaya çıkan jar dosyasına dahil edilir.
resource_configuration_filters

Dize listesi; varsayılan değer []'tir.

Apk'deki kaynakları yalnızca "en" yapılandırmasındakilerle sınırlayacak "en" gibi bir kaynak yapılandırma filtreleri listesi.
resource_jars

Etiketler listesi; varsayılan değer []'dir.

Desteği sonlandırıldı: Bunun yerine java_import ve deps veya runtime_deps kullanın.
resource_strip_prefix

Dize; varsayılan değer ""'tir

Java kaynaklarından çıkarılacak yol ön eki.

Belirtilirse bu yol ön eki, resources özelliğindeki her dosyadan çıkarılır. Bu, kaynak dosyasının bu dizinde olmamasıyla ilgili bir hatadır. Belirtilmezse (varsayılan) kaynak dosyasının yolu, Java paketinin kaynak dosyalarıyla aynı mantığa göre belirlenir. Örneğin, stuff/java/foo/bar/a.txt konumundaki bir kaynak dosya foo/bar/a.txt konumunda bulunur.

runtime_deps

Etiketler listesi; varsayılan değer []'dir.

Son ikili program veya yalnızca çalışma zamanında test için kullanılacak kitaplıklar. Normal deps gibi bu komutlar da çalışma zamanı sınıf yolunda görünür ancak bunlardan farklı olarak derleme zamanı sınıf yolunda görünmez. Yalnızca çalışma zamanında gereken bağımlılıklar burada listelenmelidir. Bağımlılık analizi araçları hem runtime_deps hem de deps içinde görünen hedefleri yoksaymalıdır.
stamp

Tam sayı; varsayılan değer 0'tür

Derleme bilgilerinin ikili programda kodlanıp kodlanmayacağını belirler. Olası değerler:
  • stamp = 1: --nostamp derlemelerinde bile derleme bilgilerini her zaman ikili dosyaya damgalayın. İkili dosya ve ona bağlı tüm yayın sonrası işlemler için uzaktan önbelleğe alma işlemini potansiyel olarak sonlandırdığından bu ayardan kaçınılmalıdır.
  • stamp = 0: Derleme bilgilerini her zaman sabit değerlerle değiştirin. Bu yöntem, derleme sonucunu önbelleğe alma konusunda iyi bir sonuç verir.
  • stamp = -1: Derleme bilgilerinin yerleştirilmesi --[no]stamp işaretiyle kontrol edilir.

Bağımlılıkları değişmediği sürece damgalı ikili programlar yeniden oluşturulmaz.

test_class

Dize; varsayılan değer ""

Test çalıştırıcı tarafından yüklenecek Java sınıfı.

Bu özellik, bu test tarafından çalıştırılacak bir Java sınıfının adını belirtir. Bunun ayarlanması nadiren gerekir. Bu bağımsız değişken atlanırsa adı, bu android_local_test kuralının name değerine karşılık gelen Java sınıfı kullanılır. Test sınıfına org.junit.runner.RunWith ile ek açıklama eklenmesi gerekiyor.

use_launcher

Boole; varsayılan değer True'tir

İkili programın özel bir başlatıcı kullanıp kullanmayacağı.

Bu özellik false (yanlış) değerine ayarlanırsa Başlatıcı özelliği ve ilgili --java_launcher işareti bu hedef için yoksayılır.

android_device

Kural kaynağını göster
android_device(name, cache, compatible_with, default_properties, deprecation, distribs, exec_compatible_with, exec_properties, features, horizontal_resolution, licenses, platform_apks, ram, restricted_to, screen_density, system_image, tags, target_compatible_with, testonly, vertical_resolution, visibility, vm_heap)

Bu kural, belirtilen özelliklerle yapılandırılmış bir Android emülatörü oluşturur. Bu emülatör, bazel run komutuyla veya oluşturulan komut dosyası doğrudan yürütülerek başlatılabilir. Kendi kurallarınızı tanımlamak yerine mevcut android_device kurallarına bağlı kalmanız önerilir.

Bu kural, bazel testi ve blaze çalıştırma için --run_under işareti için uygun bir hedeftir. Bir emülatör başlatır, test edilen/çalıştırılan hedefi emülatöre kopyalar ve uygun şekilde test eder veya çalıştırır.

Temel system_image X86 tabanlıysa ve en fazla I686 CPU mimarisi için optimize edilmişse android_device, KVM görüntüleri oluşturmayı destekler. KVM'yi kullanmak için android_device kuralına tags = ['requires-kvm'] ekleyin.

Dolaylı çıkış hedefleri

  • name_images/userdata.dat: Resim dosyalarını ve emülatörü başlatacak anlık görüntüleri içerir
  • name_images/emulator-meta-data.pb: Yeniden başlatmak için emülatöre iletilmesi gereken serileştirilmiş bilgileri içerir.

Örnekler

Aşağıdaki örnekte android_device özelliğinin nasıl kullanılacağı gösterilmektedir. //java/android/helloandroid/BUILD şunu içerir:

android_device(
    name = "nexus_s",
    cache = 32,
    default_properties = "nexus_s.properties",
    horizontal_resolution = 480,
    ram = 512,
    screen_density = 233,
    system_image = ":emulator_images_android_16_x86",
    vertical_resolution = 800,
    vm_heap = 32,
)

filegroup(
    name = "emulator_images_android_16_x86",
    srcs = glob(["androidsdk/system-images/android-16/**"]),
)

//java/android/helloandroid/nexus_s.properties şunu içerir:

ro.product.brand=google
ro.product.device=crespo
ro.product.manufacturer=samsung
ro.product.model=Nexus S
ro.product.name=soju

Bu kural, resimler ve bir başlangıç komut dosyası oluşturur. bazel run :nexus_s -- --action=start komutunu çalıştırarak emülatörü yerel olarak başlatabilirsiniz. Komut dosyası aşağıdaki işaretleri gösterir:

  • --adb_port: adb&#39;nin kullanılacağı bağlantı noktası. Emülatöre adb komutları yayınlamak istiyorsanız bu bağlantı noktası adb'nin bağlanacağı bağlantı noktasıdır.
  • --emulator_port: Emülatör telnet yönetim konsolunun açılacağı bağlantı noktası.
  • --enable_display: Doğru değerine ayarlanırsa emülatörü bir ekranla başlatır (varsayılan olarak false).
  • --action: start veya kill.
  • --apks_to_install: Emülatöre yüklenecek apk'lerin listesi.

Bağımsız değişkenler

Özellikler
name

Ad; gerekli

Bu hedef için benzersiz bir ad.

cache

Tam sayı; zorunlu

Emülatörün önbellek bölümünün megabayt cinsinden boyutu. Bunun minimum değeri 16 megabayttır.
default_properties

Etiket; varsayılan değer None'dir.

Emülatördeki /default.prop dosyasına yerleştirilecek tek bir properties dosyası. Bu, kural yazarının emülatörü gerçek bir cihaz gibi görünecek şekilde daha ayrıntılı yapılandırmasına olanak tanır (özellikle UserAgent dizelerinin ve bir uygulamanın ya da sunucunun belirli bir cihaza farklı davranmasına neden olabilecek diğer davranışların kontrol edilmesi). Bu dosyadaki özellikler, genellikle ro.product.model gibi emülatör tarafından ayarlanan salt okunur özellikleri geçersiz kılar.
horizontal_resolution

Tam sayı; zorunlu

Taklit edilecek piksel cinsinden yatay ekran çözünürlüğü. Minimum değer 240'tür.
platform_apks

Etiket listesi; varsayılan []

Başlatma sırasında cihaza yüklenecek APK'ların listesi.
ram

Tam sayı; zorunlu

Cihaz için taklit edilecek RAM miktarı (megabayt cinsinden). Bu durum, yalnızca cihazda yüklü belirli bir uygulama için değil, cihazın tamamı için geçerlidir. Minimum değer 64 megabayttır.
screen_density

Tam sayı; zorunlu

Emülasyonlu ekranın inç başına piksel cinsinden yoğunluğu. Bunun minimum değeri 30 ppi'dır.
system_image

Etiket; zorunlu

Aşağıdaki dosyaları içeren bir dosya grubu:
  • system.img: Sistem bölümü
  • kernel-qemu: Emülatörün yükleyeceği Linux çekirdeği
  • ramdisk.img: Başlatma sırasında kullanılacak başlangıç görüntüsü
  • userdata.img: İlk kullanıcı verisi bölümü
  • source.properties: Resimlerle ilgili bilgileri içeren bir özellik dosyası
Bu dosyalar Android SDK'sının bir parçasıdır veya üçüncü taraflarca sağlanır (örneğin, Intel x86 görüntüleri sağlar).
vertical_resolution

Tam sayı; zorunlu

Taklit edilecek dikey ekran çözünürlüğü (piksel). Minimum değer 240'tır.
vm_heap

Tam sayı; zorunlu

Android'in her işlem için kullanacağı sanal makine yığınının megabayt cinsinden boyutu. Minimum değer 16 megabayttır.

android_ndk_repository

Kural kaynağını göster
android_ndk_repository(name, api_level, path, repo_mapping)

Yerel kodla Android hedefleri oluşturmayı desteklemek için Bazel'i Android NDK kullanacak şekilde yapılandırır.

Bu android_ndk_repository uygulamasının Starlark'taki bir uygulamayla değiştirildiğini unutmayın. Sürüm 25 ve sonraki sürümler dahil olmak üzere NDK'nın gelecekteki sürümleri için destek, android_ndk_repository ürününün Starlark sürümünde uygulanacaktır. Starlark sürümü için rules_android_ndk bölümüne bakın.

Android için derleme işleminin, WORKSPACE dosyanızda bir android_sdk_repository kuralı da gerektirdiğini unutmayın.

Daha fazla bilgi için Android NDK'yi Bazel ile kullanmayla ilgili tüm dokümanları okuyun.

Örnekler

android_ndk_repository(
    name = "androidndk",
)

Yukarıdaki örnek, Android NDK'nızı $ANDROID_NDK_HOME cihazında bulup desteklediği en yüksek API düzeyini algılar.

android_ndk_repository(
    name = "androidndk",
    path = "./android-ndk-r20",
    api_level = 24,
)

Yukarıdaki örnekte, ./android-ndk-r20 alanındaki çalışma alanınızda bulunan Android NDK kullanılır. JNI kodunuzu derlerken API düzey 24 kitaplıklarını kullanır.

cpufeatures

Android NDK, çalışma zamanında cihazın CPU'sunu algılamak için kullanılabilen cpufeatures kitaplığını içerir. Aşağıdaki örnekte, cpufeatures&#39;in Bazel ile nasıl kullanılacağı gösterilmektedir.

# jni.cc
#include "ndk/sources/android/cpufeatures/cpu-features.h"
...
# BUILD
cc_library(
    name = "jni",
    srcs = ["jni.cc"],
    deps = ["@androidndk//:cpufeatures"],
)

Bağımsız değişkenler

Özellikler
name

Ad; gerekli

Bu hedef için benzersiz bir ad.

api_level

Tam sayı; yapılandırılmamış; varsayılan değer 0

Temel alınan Android API düzeyi. Belirtilmezse yüklü en yüksek API düzeyi kullanılır.
path

Dize; yapılandırılabilir değil; varsayılan değer ""

Android NDK&#39;nın mutlak veya göreli yolu. Bu özellik veya $ANDROID_NDK_HOME ortam değişkeni ayarlanmalıdır.

Android NDK'yı Android geliştirici sitesinden indirebilirsiniz.

repo_mapping

Sözlük: Dize -> Dize; varsayılan {}

Yerel depo adından genel depo adına bir sözlük. Bu, bu deposunun bağımlılıklarının çalışma alanı bağımlılık çözümü üzerinde kontrol sahibi olmanızı sağlar.

Örneğin, "@foo": "@bar" girişi, bu deponun "@foo"'e bağımlı olduğu her durumda ("@foo//some:target"'e bağımlılık gibi) bu bağımlılığı aslında global olarak tanımlanmış "@bar" ("@bar//some:target") içinde çözmesi gerektiğini belirtir.

android_sdk_repository

Kural kaynağını göster
android_sdk_repository(name, api_level, build_tools_version, path, repo_mapping)

Android hedeflerini oluşturmayı desteklemek için Bazel&#39;i yerel bir Android SDK&#39;sı kullanacak şekilde yapılandırır.

Örnekler

Bazel için Android SDK oluşturmak üzere minimum değer, WORKSPACE dosyanıza "androidsdk" adlı bir android_sdk_repository kuralı yerleştirmek ve $ANDROID_HOME ortam değişkenini Android SDK'nızın yoluna ayarlamaktır. Bazel varsayılan olarak en yüksek Android API düzeyini kullanır ve Android SDK'da yüklü araç araçlarını geliştirir.
android_sdk_repository(
    name = "androidsdk",
)

Yeniden oluşturulabilir derlemeler sağlamak için path, api_level ve build_tools_version özellikleri belirli değerlere ayarlanabilir. Android SDK'da belirtilen API düzeyi veya derleme araçları sürümü yüklü değilse derleme başarısız olur.

android_sdk_repository(
    name = "androidsdk",
    path = "./sdk",
    api_level = 19,
    build_tools_version = "25.0.0",
)

Yukarıdaki örnekte, Android SDK'ya çalışma alanına bağlı bir yolun kullanımı da gösterilmektedir. Bu, Android SDK Bazel çalışma alanınızın bir parçasıysa (ör. sürüm kontrolünde işaretlenmişse) yararlıdır.

Destek Kitaplıkları

Destek kitaplıkları, Android SDK Yöneticisi&#39;nde &quot;Android Destek Deposu&quot; olarak bulunur. Bu, yerel bir Maven deposu olarak paketlenmiş, Support ve AppCompat kitaplıkları gibi yaygın Android kitaplıklarından oluşan sürümlü bir gruptur. android_sdk_repository, bu kitaplıkların her biri için android_binary ve android_library hedeflerinin bağımlılıklarında kullanılabilecek Bazel hedefleri oluşturur.

Oluşturulan hedeflerin adları, Android Destek Deposu'ndaki @androidsdk//${group}:${artifact}-${version} olarak biçimlendirilmiş kitaplıkların Maven koordinatlarından türetilir. Aşağıdaki örnekte, bir android_library öğesinin v7 appcompat kitaplığının 25.0.0 sürümüne nasıl bağlı olabileceği gösterilmektedir.

android_library(
    name = "lib",
    srcs = glob(["*.java"]),
    manifest = "AndroidManifest.xml",
    resource_files = glob(["res/**"]),
    deps = ["@androidsdk//com.android.support:appcompat-v7-25.0.0"],
)

Bağımsız değişkenler

Özellikler
name

Ad; zorunlu

Bu hedef için benzersiz bir ad.

api_level

Tam sayı; yapılandırılabilir değil; varsayılan 0

Varsayılan olarak derleme için kullanılacak Android API düzeyi. Belirtilmezse yüklü en yüksek API düzeyi kullanılır.

Belirli bir derleme için kullanılan API düzeyi, android_sdk işaretiyle geçersiz kılınabilir. android_sdk_repository, bu özellik belirtilmiş olsun veya olmasın, SDK'ya yüklenmiş her API düzeyi için @androidsdk//:sdk-${level} adlı bir android_sdk hedefi oluşturur. Örneğin, varsayılan olmayan bir API düzeyine göre derleme yapmak için: bazel build --android_sdk=@androidsdk//:sdk-19 //java/com/example:app.

android_sdk_repository tarafından oluşturulan tüm android_sdk hedeflerini görüntülemek için bazel query "kind(android_sdk, @androidsdk//...)"'yi çalıştırabilirsiniz.

build_tools_version

Dize; yapılandırılamaz; varsayılan değer ""

Android SDK içinden kullanılacak Android derleme araçları sürümü. Belirtilmezse en son derleme aracı sürümü kullanılır.

Bazel için derleme araçları 30.0.0 veya sonraki bir sürüm gereklidir.

path

Dize; yapılandırılamaz; varsayılan değer ""

Android SDK'sının mutlak veya göreli yolu. Bu özellik veya $ANDROID_HOME ortam değişkeni ayarlanmalıdır.

Android SDK'yı Android geliştirici sitesinden indirebilirsiniz.

repo_mapping

Sözlük: Dize -> Dize; varsayılan değer {}'tir

Yerel depo adından genel depo adına bir sözlük. Bu, bu deposunun bağımlılıklarının çalışma alanı bağımlılık çözümü üzerinde kontrol sahibi olmanızı sağlar.

Örneğin, "@foo": "@bar" girişi, bu deponun "@foo"'e bağımlı olduğu her durumda ("@foo//some:target"'e bağımlılık gibi) bu bağımlılığı aslında global olarak tanımlanmış "@bar" ("@bar//some:target") içinde çözmesi gerektiğini belirtir.