Uygulamanızın kullanıcı arayüzü kaynaklarını Resource Manager ile yönetin

Resource Manager, uygulamanızdaki kaynakları içe aktarmak, oluşturmak, yönetmek ve kullanmak için kullanılan bir araç penceresidir. Araç penceresini açmak için menüden View > Tool Windows > Resource Manager'ı (Görünüm > Araç Pencereleri > Resource Manager) veya sol kenar çubuğundan Resource Manager'ı seçin.

Android Studio'daki Kaynak Yöneticisi araç penceresi.
Şekil 1. Kaynak Yöneticisi aracı penceresi.
  1. Projenize yeni bir kaynak eklemek için Ekle'yi tıklayın. Resim öğeleri, vektör öğeleri, yazı tipleri veya kaynak dosyaları ve değerleri ekleyebilir ya da projenize çizilebilir öğeler içe aktarabilirsiniz.
  2. Modüle özel kaynakları görüntülemek için bir modül seçin.
  3. Arama çubuğunu kullanarak projenizdeki tüm modüllerde bir kaynak arayabilirsiniz.
  4. Kaynaklarınızı Kaynak Yöneticisi'nde türe göre görüntüleyin. Kaynak türleri arasında geçiş yapmak için bu sekmeleri kullanın. Diğer kaynak türlerini görmek için taşma simgesini Diğer seçenekler menü düğmesi tıklayın.
  5. Filtre düğmesini kullanarak yerel bağımlı modüllerden, harici kitaplıklardan ve Android çerçevesinden görüntülenen kaynakları filtreleyin. Tema özelliklerini göstermek için filtreyi de kullanabilirsiniz.
  6. Ana içerik alanında kaynaklarınızı önizleyin. Bir kaynağı sağ tıklayarak kaynağı yeniden adlandırabileceğiniz ve uygulamanızda kaynağın kullanıldığı yerleri arayabileceğiniz bir bağlam menüsü görebilirsiniz.
  7. Kaynaklarınızı blok veya liste olarak görüntülemek için bu düğmeleri tıklayın.
  8. Kaynaklarınızın önizleme boyutunu değiştirmek için bu düğmeleri tıklayın.

Bu özelliklere ek olarak Kaynak Yöneticisi, çizilebilir öğeleri projenize toplu olarak içe aktarmanıza olanak tanır. Toplu içe aktarma işlemi için şunlardan birini yapabilirsiniz:

  • SVG dosyaları da dahil olmak üzere resim dosyalarınızı doğrudan Kaynak Yöneticisi'ne sürükleyin.
  • Çizilebilirleri İçe Aktarma sihirbazını kullanın.

Daha fazla bilgi için Çizilebilir öğeleri projenize aktarma bölümüne bakın.

Daha ayrıntılı bilgi görmek için Kaynak Yöneticisi'nde bir kaynağı çift tıklayın. Bir kaynağın birden fazla sürümü varsa bu ayrıntılı görünümde her sürüm, ilişkili niteleyicilerle birlikte gösterilir (Şekil 2'de gösterildiği gibi). Buradan, belirli bir sürümü çift tıklayarak düzenleyici penceresinde açabilirsiniz.

Farklı ekran yoğunlukları için bir drawable kaynağının sürümlerini gösteren Kaynak Yöneticisi.
Şekil 2. Farklı ekran yoğunlukları için bir resim kaynağının sürümlerini gösteren Kaynak Yöneticisi.

Çizilebilir öğeleri projenize aktarma

Resim kaynaklarını projenize aktarmak için Kaynak Yöneticisi'ni kullanabilirsiniz. Desteklenen resim türlerinin listesi için Resim desteği bölümüne bakın.

Resim kaynaklarını projenize aktarmak için aşağıdakileri yapın:

  1. Resimlerinizi doğrudan Android Studio'daki Kaynak Yöneticisi penceresine sürükleyin.

    • Bu işlemi şu şekilde de yapabilirsiniz:
      1. Artı simgesini (+) tıklayın.
      2. Şekil 3'te gösterildiği gibi Import Drawables'ı (Çizilebilir Öğeleri İçe Aktar) seçin.
      3. İçe aktarmak istediğiniz dosya ve klasörleri seçin.
    Kaynak Yöneticisi'nin ekleme menüsünden "Import Drawables"ı (Çizilebilir Öğeleri İçe Aktar) seçin.
    Şekil 3. Menüden Import Drawables'ı (Çizilebilir Öğeleri İçe Aktar) seçin.
  2. Şekil 4'te gösterildiği gibi Import drawables (Çizilebilir öğeleri içe aktar) iletişim kutusu görünür. Bu iletişim kutusunda, içe aktardığınız kaynakların listesi gösterilir. Bir kaynağın önizlemesinin üstündeki kutuyu tıklayarak kaynakları yeniden adlandırabilirsiniz.

    Aynı kaynağın birden fazla sürümünü sağlıyorsanız aşağıdaki bölümde açıklandığı gibi, her kaynağın desteklediği belirli yapılandırmayı açıklayan cihaz yapılandırma niteleyicileri ekleyin.

    Örneğin, farklı ekran yoğunlukları için aynı kaynağın birden fazla sürümünü sağlıyorsanız her sürüm için bir Yoğunluk niteleyici ekleyebilirsiniz. İki veya daha fazla kaynağın aynı ada ve niteleyicilere sahip olması durumunda yalnızca bir sürümün içe aktarılacağını unutmayın.

    Kaynak niteleyiciler hakkında daha fazla bilgi için Alternatif kaynaklar sağlama başlıklı makaleyi inceleyin.

    Kaynak adlarını ve niteleyicileri gösteren "Çizilebilir öğeleri içe aktar" iletişim kutusu.
    Şekil 4. Çizilebilir öğeleri içe aktar iletişim kutusu.

    Kaynaklarınızı adlandırıp gerekli niteleyicileri ekledikten sonra İleri'yi tıklayın.

  3. Sonraki ekranda, içe aktardığınız kaynakların bir özeti gösterilir. İçe aktarmaya hazır olduğunuzda İçe aktar'ı tıklayın.

Resource Manager penceresinde, kaynaklarınız artık projenizde kullanılmaya hazır. Bu durum Şekil 5'te gösterilmiştir.

Yeni içe aktarılan resim kaynaklarını gösteren Kaynak Yöneticisi.
Şekil 5. Kaynak Yöneticisi artık içe aktarılan resimlerinizi gösterir.

Çizilebilir yoğunlukları otomatik olarak ayrıştırma

Bir dosya veya klasör içe aktardığınızda ve yolunda yoğunluk niteleyici varsa Kaynak Yöneticisi, içe aktarma işleminin bir parçası olarak yoğunluk niteleyiciyi otomatik olarak uygular. Kaynak Yöneticisi, hem Android'in yoğunluk niteleyicilerini hem de iOS'in ölçeklendirme faktörlerini ayrıştırabilir.

Bu tabloda, desteklenen farklı yoğunlukların Android ve iOS için nasıl temsil edildiği listelenmiştir:

Yoğunluk Android yoğunluk niteleyici iOS ölçeklendirme faktörü
Düşük yoğunluk (~120 dpi) ldpi desteklenmiyor
Orta yoğunluk (~160 dpi) mdpi orijinal ölçek
Yüksek yoğunluk (~240 dpi) hdpi desteklenmiyor
Ekstra yüksek yoğunluk (~320 dpi) xhdpi @2x
Ekstra ekstra yüksek yoğunluk (~480 dpi) xxhdpi @3x
Ekstra ekstra ekstra yüksek yoğunluk (~640 dpi) xxxhdpi @4x

İçe aktarma işleminden sonra giriş yollarının kaynak yollarına nasıl dönüştürüldüğüne dair bazı örnekleri aşağıda bulabilirsiniz:

Android yoğunluk niteleyici: hdpi
Giriş yolu: /UserFolder/icon1/hdpi/icon.png
Kaynak yolu: <projectFolder>/<moduleFolder> /src/main/res/drawable-hdpi/icon.png
Android yoğunluk niteleyici: xxhdpi
Giriş yolu: /UserFolder/icon1/abc-xxhdpi/icon.png
Kaynak yolu: <projectFolder>/<moduleFolder> /src/main/res/drawable-xxhdpi/icon.png
iOS ölçeklendirme faktörü: @2x
Giriş yolu: /UserFolder/icon1/icon@2x.png
Kaynak yolu: <projectFolder>/<moduleFolder> /src/main/res/drawable-xhdpi/icon.png
iOS ölçeklendirme faktörü: @2x
Giriş yolu: /UserFolder/icon1/icon@2x_alternate.png
Kaynak yolu: <projectFolder>/<moduleFolder> /src/main/res/drawable-xhdpi/icon_alternate.png

Farklı piksel yoğunluklarına sahip cihazları destekleme hakkında daha fazla bilgi için Farklı piksel yoğunluklarını destekleme başlıklı makaleyi inceleyin.

Jetpack Compose'da kaynakları kullanma

Jetpack Compose ile uygulama geliştirirken optimize edilmiş API'leri kullanarak kaynaklara doğrudan Kotlin kodunuzdan erişirsiniz. Böylece kullanıcı arayüzü mantığınız ve kaynak referanslarınız senkronize kalır.

  • Resimler: Image composable'da painterResource(id = R.drawable.your_image) kullanın.
  • Dizeler: Yerelleştirilmiş kullanıcı arayüzü metnini almak için stringResource(id = R.string.your_string) kullanın.
  • Renkler: Temada tanımlanan renkleri uygulamak için colorResource(id = R.color.your_color) kullanın.

Resource Manager, bu kimliklerin doğru şekilde oluşturulmasını sağlayarak öğelerinize Compose kullanıcı arayüzü hiyerarşinizden sorunsuz bir şekilde referans vermenize olanak tanır.

Dinamik yazı tipi yükleme, yapılandırmaya özel kaynaklar ve Compose'a özel kaynak kitaplıkları dahil olmak üzere gelişmiş kaynak işleme hakkında bilgi edinmek için Compose'daki kaynaklar ile ilgili belgelere bakın.

Ek kaynaklar

İçerik görüntüleme