Android Kuralları

Kurallar

• android_binary
• aar_import
• android_library
• android_applianceation_test
• android_local_test
• android_device
• android_ndk_depository
• android_sdk_repository

android_binary

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.

Örtük çıkış hedefleri

• name.apk: Hata ayıklama anahtarlarıyla imzalanan ve sıkıştırılmış bir Android uygulama paketi dosyası, uygulamanızı geliştirmek ve hata ayıklamak için kullanılabilir. Hata ayıklama anahtarlarıyla imzalandığında uygulamanızı serbest bırakamazsınız.
• name_unsigned.apk: Yukarıdaki dosyanın herkese açık olarak yayınlanmadan önce, sürüm anahtarlarıyla imzalanabilecek imzalanmamış bir sürümüdür.
• name_deploy.jar: Bu hedefin geçici olarak kapatılmasını içeren bir Java arşivi.

  Dağıtım havuzu, bu hedefin çalışma zamanı sınıf yolunu başından sonuna kadar arayan bir sınıf yükleyici tarafından bulunabilecek tüm sınıfları içerir.

• name_proguard.jar: ProGuard'ı name_deploy.jar üzerinde çalıştırmanın sonucunu içeren Java arşivi. Bu çıkış yalnızca proGuard_specs özelliği belirtilirse oluşturulur.
• name_proguard.map: ProGuard'ı name_deploy.jar üzerinde çalıştırmanın bir eşleme dosyası sonucu. Bu çıkış yalnızca proGuard_specs özelliği belirtildiğinde ve proGuard_generate_mapping veyashrink_resources ayarlanmışsa oluşturulur.

Örnekler

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

Bağımsız değişkenler

          android/support/multidex/MultiDex$V19.class
          android/support/multidex/MultiDex.class
          android/support/multidex/MultiDexApplication.class
          com/google/common/base/Objects.class
                    

aar_içe aktarma

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, .aar dosyalarının android_library ve android_binary kuralları için kitaplık olarak kullanılmasına izin verir.

Ö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

android_kitaplığı

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, dolaylı olarak derleme sınıfı yoluna yerleştirilir.

Örtük çı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. Toplu taşıma kapalı değildir.

Örnekler

Android kural örneklerini Basiel 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çermelidir:

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

Android_Araçları_Testi

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)

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 ve test paketinde tanımlanan testleri çalıştırır.

test_app özelliği, testi içeren android_binary özelliğini belirtir. Buna karşılık, bu android_binary, tools ö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

android_local_test

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ın yerel olarak (cihaz üzerinde değil) yerel olarak test edilmesi için geçerlidir. Android Robolectric test çerçevesiyle çalışır. Robolectric testlerini yazmayla ilgili ayrıntılar için Android Robolectric sitesine bakın.

Örtük çı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 istendiğinde oluşturulur).

Örnekler

Robolectric'i android_local_test ile kullanmak için robolectric'in deposunu WORKSPACE dosyanıza 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()

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

android_cihazı

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 spesifikasyonlarla yapılandırılmış bir Android emülatörü oluşturur. Bu emülatör, bir bazel çalıştırma komutuyla veya oluşturulan komut dosyası doğrudan yürütülerek başlatılabilir. Kendi android cihazınızı tanımlamak yerine mevcut android_device kurallarına güvenmeniz önerilir.

Bu kural, test ve son test çalıştırması 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 kopyalar ve emülatöre kopyalar, test eder veya uygun şekilde ç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.

Örtük çıkış hedefleri

• name_images/userdata.dat: Emülatörü başlatmak için resim dosyaları ve anlık görüntüler içerir
• name_images/emulator-meta-data.pb: Emülatörü yeniden başlatmak için gereken serileştirilmiş bilgileri içerir.

Örnekler

Aşağıdaki örnekte android_device cihazının 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 şunları 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 başlangıç komut dosyası oluşturur. bazel çalıştırma: :nexus_s -- --action=start komutunu çalıştırarak emülatörü yerel olarak başlatabilirsiniz. Komut dosyası aşağıdaki işaretleri açığa çıkarır:

• --adb_port: Adb'nin gösterildiği bağlantı noktası. Emülatöre adb komutları yayınlamak isterseniz adb'ye bağlanacağınız bağlantı noktası budur.
• --emulator_port: Emülatörün telnet yönetim konsolunun gösterildiği bağlantı noktası.
• --enable_display: Doğruysa (emülatörü yanlış) varsayılan olarak emülatörü başlatır.
• --action: Başlatın veya öldürün.
• --apks_to_install: emülatöre yüklenecek apk'lerin listesi.

Bağımsız değişkenler

android_ndk_depo

android_ndk_repository(name, api_level, path, repo_mapping)

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

android_ndk_repository uygulamasının bu sürümünün yerini Starlark uygulamasında bir uygulama aldığını unutmayın. NDK'nın 25 ve sonraki sürümleri dahil olmak üzere 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 sayfasına göz atın.

Android için derlemenin WORKSPACE dosyanızda de bir android_sdk_repository kuralı gerektiğini unutmayın.

Daha fazla bilgi için Android NDK'yı Bazel ile kullanma hakkındaki belgelerin tamamını okuyun.

Örnekler

android_ndk_repository(
    name = "androidndk",
)

Yukarıdaki örnek, $ANDROID_NDK_HOME cihazından Android NDK'nızı bulur ve desteklediği en yüksek API düzeyini tespit eder.

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

Yukarıdaki örnekte, ./android-ndk-r20 içindeki çalışma alanınızın içinde bulunan Android NDK kullanılacak. JNI kodunuzu derlerken API düzeyi 24 kitaplıklarını kullanır.

cpuözellikleri

Android NDK, çalışma zamanında bir cihazın CPU'sunu algılamak için kullanılabilecek cpufeatures kitaplığını içerir. Aşağıdaki örnekte CPU özelliklerinin 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

android_sdk_deposu

android_sdk_repository(name, api_level, build_tools_version, path, repo_mapping)

Bazel'ı, Android hedeflerini oluşturmayı desteklemek için yerel bir Android SDK'sı kullanacak şekilde yapılandırır.

Örnekler

android_sdk_repository(
    name = "androidsdk",
)

Tekrarlanabilir 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 örnek, Android SDK'sı için çalışma alanına bağlı bir yol kullanımını da göstermektedir. Bu işlem, Android SDK'sının Bazel çalışma alanınızın bir parçası olması durumunda yararlıdır (ör. sürüm denetimine dahil edilmişse).

Destek Kitaplıkları

Destek Kitaplıkları, Android SDK Manager'da "Android Support Repository" olarak kullanılabilir. Bu, Yerel Maven deposu olarak paketlenmiş olan, Destek ve AppCompat kitaplıkları gibi ortak Android kitaplıklarının oluşturulmuş bir grubudur. android_sdk_repository, bu kitaplıkların her biri için Bazel hedefleri oluşturur. Bu hedefler android_binary ve android_library hedeflerinin bağımlılarında kullanılabilir.

Oluşturulan hedeflerin adları, @androidsdk//${group}:${artifact}-${version} olarak biçimlendirilmiş Android Destek Deposu'ndaki kitaplıkların Maven koordinatlarından türetilir. Aşağıdaki örnekte android_library ürününün 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