Bazel Eğitimi: Android Uygulaması Oluşturma

Sorun bildirin Kaynağı göster

Not: Android uygulaması oluşturmak için Bazel kullanmayla ilgili bilinen sınırlamalar vardır. Bilinen sorunların listesini görmek için GitHub team-Android hotspot'u ziyaret edin. Bazel ekibi ve Açık Kaynak Yazılım'a (OSS) katkıda bulunanlar, bilinen sorunları gidermek için aktif olarak çalışsalar da kullanıcılar, Android Studio'nun Bazel projelerini resmi olarak desteklemediğinin farkında olmalıdır.

Bu eğiticide, Bazel kullanarak basit bir Android uygulamasının nasıl oluşturulacağı ele alınmaktadır.

Bazel, Android kurallarını kullanarak Android uygulamaları oluşturmayı destekler.

Bu eğitim Windows, macOS ve Linux kullanıcıları için hazırlanmıştır ve Bazel veya Android uygulama geliştirme konusunda deneyim sahibi olmayı gerektirmez. Bu eğiticide herhangi bir Android kodu yazmanız gerekmez.

Neler öğreneceksiniz?

Bu eğitimde şunları öğreneceksiniz:

  • Bazel ve Android Studio'yu yükleyip örnek projeyi indirerek ortamınızı ayarlayın.
  • Uygulamanın kaynak kodunu içeren bir Bazel çalışma alanı ve çalışma alanı dizininin en üst düzeyini tanımlayan bir WORKSPACE dosyası oluşturun.
  • WORKSPACE dosyasını, Android SDK gibi gerekli harici bağımlılıklara ilişkin referansları içerecek şekilde güncelleyin.
  • Bir BUILD dosyası oluşturun.
  • Uygulamayı Bazel ile oluşturun.
  • Uygulamayı bir Android emülatörüne veya fiziksel cihaza dağıtıp çalıştırın.

Başlamadan önce

Bazel'i yükleme

Eğiticiye başlamadan önce aşağıdaki yazılımları yükleyin:

  • Bazel. Yüklemek için yükleme talimatlarını uygulayın.
  • Android Studio. Yüklemek için Android Studio'yu indirme adımlarını uygulayın. SDK'yı indirmek ve ortamınızı yapılandırmak için kurulum sihirbazını çalıştırın.
  • (İsteğe bağlı) Git. Android uygulama projesini indirmek için git uygulamasını kullanın.

Örnek projeyi alma

Örnek proje için Bazel'in örnek deposunda temel bir Android uygulama projesi kullanın.

Bu uygulamada, tıklandığında karşılama mesajı yazdıran tek bir düğme var:

Düğmeden karşılama mesajı

Şekil 1. Android uygulama düğmesinden karşılama mesajı.

Depoyu git ile klonlayın (veya ZIP dosyasını doğrudan indirin):

git clone https://github.com/bazelbuild/examples

Bu eğitimin örnek projesi examples/android/tutorial konumundadır. Eğiticinin geri kalanında komutları bu dizinde yürüteceksiniz.

Kaynak dosyaları inceleyin

Uygulamanın kaynak dosyalarına göz atın.

.
├── README.md
└── src
    └── main
        ├── AndroidManifest.xml
        └── java
            └── com
                └── example
                    └── bazel
                        ├── AndroidManifest.xml
                        ├── Greeter.java
                        ├── MainActivity.java
                        └── res
                            ├── layout
                            │   └── activity_main.xml
                            └── values
                                ├── colors.xml
                                └── strings.xml

Önemli dosya ve dizinler şunlardır:

Ad Konum
Android manifest dosyaları src/main/AndroidManifest.xml ve src/main/java/com/example/bazel/AndroidManifest.xml
Android kaynak dosyaları src/main/java/com/example/bazel/MainActivity.java ve Greeter.java
Kaynak dosyası dizini src/main/java/com/example/bazel/res/

Bazel ile geliştirin

Çalışma alanını ayarlama

Çalışma alanı, bir veya daha fazla yazılım projesinin kaynak dosyalarını içeren ve kök dizininde WORKSPACE dosyası bulunan bir dizindir.

WORKSPACE dosyası boş olabilir veya projenizi derlemek için gereken dış bağımlılıklara referanslar içerebilir.

Öncelikle boş bir WORKSPACE dosyası oluşturmak için aşağıdaki komutu çalıştırın:

OS Komut
Linux, macOS touch WORKSPACE
Windows (Komut İstemi) type nul > WORKSPACE
Windows (PowerShell) New-Item WORKSPACE -ItemType file

Bazel çalıştırılıyor

Artık şu komutu kullanarak Bazel'in düzgün çalışıp çalışmadığını kontrol edebilirsiniz:

bazel info workspace

Bazel geçerli dizinin yolunu yazdırırsa devam edebilirsiniz. WORKSPACE dosyası mevcut değilse şuna benzer bir hata mesajı görebilirsiniz:

ERROR: The 'info' command is only supported from within a workspace.

Android SDK ile entegrasyon

Bazel'in uygulamayı derlemesi için Android SDK derleme araçlarını çalıştırması gerekir. Diğer bir deyişle, Bazel'in bunları nerede bulacağını bilmesi için WORKSPACE dosyanıza bazı bilgiler eklemeniz gerekir.

WORKSPACE dosyanıza aşağıdaki satırı ekleyin:

android_sdk_repository(name = "androidsdk")

Bu, Android SDK'yı ANDROID_HOME ortam değişkeni tarafından başvurulan yolda kullanır ve ilgili konumda yüklü en yüksek API düzeyini ve derleme araçlarının en son sürümünü otomatik olarak algılar.

ANDROID_HOME değişkenini Android SDK'nın konumuna ayarlayabilirsiniz. Android Studio'nun SDK Yöneticisi'ni kullanarak yüklü SDK'nın yolunu bulun. SDK'nın varsayılan konumlara yüklendiğini varsayarsak ANDROID_HOME değişkenini ayarlamak için aşağıdaki komutları kullanabilirsiniz:

OS Komut
Linux export ANDROID_HOME=$HOME/Android/Sdk/
macOS export ANDROID_HOME=$HOME/Library/Android/sdk
Windows (Komut İstemi) set ANDROID_HOME=%LOCALAPPDATA%\Android\Sdk
Windows (PowerShell) $env:ANDROID_HOME="$env:LOCALAPPDATA\Android\Sdk"

Yukarıdaki komutlar, değişkeni yalnızca geçerli kabuk oturumu için ayarlar. Bu ayarları kalıcı hale getirmek için aşağıdaki komutları çalıştırın:

OS Komut
Linux echo "export ANDROID_HOME=$HOME/Android/Sdk/" >> ~/.bashrc
macOS echo "export ANDROID_HOME=$HOME/Library/Android/Sdk/" >> ~/.bashrc
Windows (Komut İstemi) setx ANDROID_HOME "%LOCALAPPDATA%\Android\Sdk"
Windows (PowerShell) [System.Environment]::SetEnvironmentVariable('ANDROID_HOME', "$env:LOCALAPPDATA\Android\Sdk", [System.EnvironmentVariableTarget]::User)

path, api_level ve build_tools_version özelliklerini ekleyerek Android SDK'nın mutlak yolunu, API düzeyini ve kullanılacak derleme araçlarının sürümünü de açıkça belirtebilirsiniz. api_level ve build_tools_version belirtilmezse android_sdk_repository kuralı, SDK'daki ilgili en son sürümü kullanır. SDK'da bulundukları sürece bu özelliklerin herhangi bir kombinasyonunu belirtebilirsiniz. Örneğin:

android_sdk_repository(
    name = "androidsdk",
    path = "/path/to/Android/sdk",
    api_level = 25,
    build_tools_version = "30.0.3"
)

Windows'da, path özelliğinin karma stilde yolu, yani düz eğik çizgi içeren bir Windows yolunu kullanması gerektiğini unutmayın:

android_sdk_repository(
    name = "androidsdk",
    path = "c:/path/to/Android/sdk",
)

İsteğe bağlı: Android uygulamanızda yerel kod derlemek istiyorsanız Android NDK'yı da indirmeniz ve WORKSPACE dosyanıza aşağıdaki satırı ekleyerek Bazel'e kodu nerede bulacağını bildirmeniz gerekir:

android_ndk_repository(name = "androidndk")

android_sdk_repository özelliğine benzer şekilde, Android NDK'nın yolu da varsayılan olarak ANDROID_NDK_HOME ortam değişkeninden tahmin edilir. Yol, android_ndk_repository üzerinde path özelliğiyle açıkça belirtilebilir.

Daha fazla bilgi için Android Yerel Geliştirme Kiti'ni Bazel ile Kullanma bölümünü okuyun.

api_level, SDK ve NDK'nın hedeflediği Android API sürümüdür. Örneğin, Android 6.0 için 23 ve Android 7.1 için 25. Açıkça ayarlanmazsa api_level, android_sdk_repository ve android_ndk_repository için varsayılan olarak mevcut en yüksek API düzeyine ayarlanır.

API düzeylerinin SDK ve NDK için aynı değere ayarlanmasına gerek yoktur. Bu sayfada, Android sürümlerinden NDK destekli API düzeylerine kadar olan bir harita bulunmaktadır.

BUILD dosyası oluşturun

BUILD dosyası, bir derleme çıkışı kümesi (ör. aapt kaynağından derlenmiş Android kaynakları veya javac ürününden derlenen sınıf dosyaları) ve bunların bağımlılıkları arasındaki ilişkiyi açıklar. Bu bağımlılıklar çalışma alanınızdaki kaynak dosyalar (Java, C++) veya başka derleme çıkışları olabilir. BUILD dosyaları Starlark adı verilen bir dilde yazılır.

BUILD dosyaları, Bazel'de paket hiyerarşisi olarak bilinen bir kavramın parçasıdır. Paket hiyerarşisi, çalışma alanınızdaki dizin yapısının üzerini kaplayan mantıksal bir yapıdır. Her paket, ilgili kaynak dosya kümesi ve bir BUILD dosyası içeren bir dizindir (ve alt dizinleridir). Paket, kendi BUILD dosyasını içerenler hariç tüm alt dizinleri de içerir. Paket adı, WORKSPACE ile göreceli BUILD dosyasının yoludur.

Bazel'in paket hiyerarşisinin, BUILD dosyasının bulunduğu Android App dizininizin Java paket hiyerarşisinden kavram olarak farklı olduğunu unutmayın. Ancak dizinler aynı şekilde düzenlenebilir.

Bu eğitimdeki basit Android uygulaması için src/main/ içindeki kaynak dosyalar tek bir Bazel paketinden oluşur. Daha karmaşık projelerde iç içe yerleştirilmiş çok sayıda paket olabilir.

android_library kuralı ekleme

BUILD dosyası, Bazel için birkaç farklı bildirim türü içerir. En önemli tür, Bazel'a bir kaynak dosyalar veya diğer bağımlılıklar kümesinden ara veya nihai bir yazılım çıkışının nasıl oluşturulacağını söyleyen derleme kuralıdır. Bazel, Android uygulaması geliştirmek için kullanabileceğiniz iki derleme kuralı (android_library ve android_binary) sunar.

Bu eğitimde ilk olarak android_library kuralını kullanarak Bazel'a uygulama kaynak kodundan ve kaynak dosyalarından bir Android kitaplık modülü oluşturmasını söyleyin. Ardından, Bazel'a Android uygulama paketini nasıl oluşturacağını açıklamak için android_binary kuralını kullanacaksınız.

src/main/java/com/example/bazel dizininde yeni bir BUILD dosyası oluşturun ve yeni bir android_library hedefi bildirin:

src/main/java/com/example/bazel/BUILD:

package(
    default_visibility = ["//src:__subpackages__"],
)

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

android_library derleme kuralı, Bazel'in kaynak dosyalardan kitaplık modülü oluşturmak için ihtiyaç duyduğu bilgileri belirten bir dizi özellik içerir. Ayrıca, kuralın adının greeter_activity olduğunu da unutmayın. android_binary kuralında bağımlılık olarak bu adı kullanan kurala referans verirsiniz.

android_binary kuralı ekleyin

android_binary kuralı, uygulamanız için Android uygulama paketini (.apk dosyası) oluşturur.

src/main/ dizininde yeni bir BUILD dosyası oluşturun ve yeni bir android_binary hedefi bildirin:

src/main/BUILD:

android_binary(
    name = "app",
    manifest = "AndroidManifest.xml",
    deps = ["//src/main/java/com/example/bazel:greeter_activity"],
)

Burada deps özelliği, yukarıda BUILD dosyasına eklediğiniz greeter_activity kuralının çıkışına referans verir. Yani Bazel, bu kuralın çıktısını oluştururken önce greeter_activity kitaplık kuralı çıktısının oluşturulup oluşturulmadığını ve güncel olup olmadığını kontrol eder. Aksi takdirde, Bazel paketi oluşturur ve bu çıkışı kullanarak uygulama paketi dosyasını oluşturur.

Şimdi dosyayı kaydedin ve kapatın.

Uygulamayı oluşturma

Uygulamayı derlemeyi deneyin. android_binary hedefini derlemek için aşağıdaki komutu çalıştırın:

bazel build //src/main:app

build alt komutu, Bazel'a sonrasında gelen hedefi oluşturma talimatı verir. Hedef, çalışma alanı dizininize göre paket yolu ile birlikte BUILD dosyasındaki bir derleme kuralının adı olarak belirtilir. Bu örnekte hedef app, paket yolu ise //src/main/ şeklindedir.

Komut satırındaki mevcut çalışma dizininize ve hedefin adına bağlı olarak bazen paket yolunu veya hedef adını dahil edebileceğinizi unutmayın. Hedef etiketler ve yollar hakkında daha fazla ayrıntı için Etiketler bölümüne bakın.

Bazel örnek uygulamayı derlemeye başlar. Derleme işlemi sırasında, çıktısı aşağıdakine benzer görünür:

INFO: Analysed target //src/main:app (0 packages loaded, 0 targets configured).
INFO: Found 1 target...
Target //src/main:app up-to-date:
  bazel-bin/src/main/app_deploy.jar
  bazel-bin/src/main/app_unsigned.apk
  bazel-bin/src/main/app.apk

Derleme çıkışlarını bulma

Bazel hem ara hem de son derleme işlemlerinin çıkışlarını, kullanıcı ve çalışma alanı başına çıktı dizini grubuna yerleştirir. Bu dizinler, proje dizininin en üst seviyesinde bulunan aşağıdaki konumlardan birbirine bağlıdır. Burada WORKSPACE bulunur:

  • bazel-bin, yürütülebilir ikili programları ve çalıştırılabilir diğer derleme çıkışlarını depolar
  • bazel-genfiles, Bazel kuralları tarafından oluşturulan aracı kaynak dosyalarını depolar
  • bazel-out, diğer derleme çıkışı türlerini depolar

Bazel, android_binary kuralı kullanılarak oluşturulan Android .apk dosyasını bazel-bin/src/main dizininde depolar. Burada src/main alt dizin adı Bazel paketinin adından türetilir.

Bir komut isteminde bu dizinin içeriğini listeleyin ve app.apk dosyasını bulun:

OS Komut
Linux, macOS ls bazel-bin/src/main
Windows (Komut İstemi) dir bazel-bin\src\main
Windows (PowerShell) ls bazel-bin\src\main

Uygulamayı çalıştırın

Artık bazel mobile-install komutunu kullanarak komut satırından uygulamayı bağlı bir Android cihaza veya emülatöre dağıtabilirsiniz. Bu komut, cihazla iletişim kurmak için Android Debug Bridge'i (adb) kullanır. Dağıtımdan önce Android Hata Ayıklama Köprüsü'ndeki talimatları uygulayarak cihazınızı adb kullanacak şekilde ayarlamanız gerekir. Uygulamayı Android Studio'da bulunan Android emülatörüne de yükleyebilirsiniz. Aşağıdaki komutu çalıştırmadan önce emülatörün çalıştığından emin olun.

Aşağıdakileri girin:

bazel mobile-install //src/main:app

Sonra, "Bazel Eğitim Uygulaması"nı bulup başlatın:

Bazel eğitim uygulaması

Şekil 2. Bazel eğitim uygulaması.

Tebrikler! Bazel tarafından oluşturulan ilk Android uygulamanızı yüklediniz.

mobile-install alt komutunun, uygulamanın yalnızca son dağıtımdan bu yana değişen kısımlarını dağıtmak için kullanılabilen --incremental işaretini de desteklediğini unutmayın.

Ayrıca, uygulamayı yükler yüklemez başlatmak için --start_app işaretini de destekler.

Daha fazla bilgi

Daha fazla bilgi için şu sayfalara bakın:

Mutlu binalar!