Yeni cihaz için modül ekleme

Modüller, uygulamanızın kaynak kodu, kaynak dosyaları ve uygulama düzeyindeki ayarlar (ör. modül düzeyindeki derleme dosyası ve Android manifest dosyası) için bir kapsayıcı sağlar. Her modül bağımsız olarak oluşturulabilir, test edilebilir ve hata ayıklama yapılabilir.

Android Studio, projenize yeni cihazlar eklemeyi kolaylaştırmak için modüller kullanır. Android Studio'da birkaç basit adımı uygulayarak Wear OS veya Android TV gibi bir cihaz türüne özel kod içeren bir modül oluşturabilirsiniz. Android Studio, kaynak ve kaynak dizinleri gibi modül dizinlerini ve cihaz türüne uygun varsayılan bir build.gradle dosyasını otomatik olarak oluşturur. Ayrıca Android Studio, önerilen derleme yapılandırmaları içeren cihaz modülleri oluşturur (örneğin, Android TV modülleri için Leanback kitaplığını kullanmak).

Bu sayfada, belirli bir cihaz için yeni modülün nasıl ekleneceği açıklanmaktadır.

Android Studio, projenize kitaplık veya Google Cloud modülü eklemeyi de kolaylaştırır. Kitaplık modülü oluşturma hakkında ayrıntılı bilgi için Kitaplık Modülü oluşturma bölümünü inceleyin.

Yeni modül oluşturun

Yeni bir cihaz için projenize yeni modül eklemek üzere aşağıdaki adımları uygulayın:

  1. Dosya > Yeni > Yeni Modül'ü tıklayın.
  2. Görüntülenen Yeni Modül Oluştur penceresinde, Android Studio aşağıdaki cihaz modüllerini sunar:
    • Telefon ve Tablet Modülü
    • Wear OS Modülü
    • Android TV Modülü
    • Cam Modül
    İstediğiniz cihaza ait modülü seçin ve ardından İleri'yi tıklayın.
  3. Yeni modülünüzü yapılandırın formunda aşağıdaki ayrıntıları girin:
    • Uygulama Adı: Bu ad, yeni modül için uygulama başlatıcı simgenizin başlığı olarak kullanılır.
    • Modul Adı: Bu metin, kaynak kodunuzun ve kaynak dosyalarınızın görünür olduğu klasörün adı olarak kullanılır.
    • Paket Adı: Modülünüzdeki kodun Java ad alanıdır. Modülün Android manifest dosyasına package özelliği olarak eklenir.
    • Minimum SDK: Bu ayar, uygulama modülünün desteklediği Android platformunun en düşük sürümünü belirtir. Bu değer, daha sonra düzenleyebileceğiniz build.gradle dosyasındaki minSdkVersion özelliğini ayarlar.

    Ardından, Sonraki'yi tıklayın.

  4. Seçtiğiniz cihaz modülüne bağlı olarak, aşağıdaki sayfada ana etkinliğiniz olarak kullanmak için seçebileceğiniz bir dizi uygun kod şablonu gösterilir. Başlamak istediğiniz etkinlik şablonunu ve ardından İleri'yi tıklayın. Bir etkinliğe ihtiyacınız yoksa Etkinlik Ekle'yi ve Son'u tıklayın. Hepsi bu kadar.
  5. Bir etkinlik şablonu seçerseniz Etkinliği Özelleştir sayfasında etkinliğinize ilişkin ayarları girin. Çoğu şablonda Etkinlik Adı, Düzen Adı, Başlık ve Kaynak Dil bilgileri istenir ancak her şablonun etkinliğe özgü ayarları vardır. Son'u tıklayın. Etkinlik şablonu içeren bir uygulama modülü oluşturduğunuzda, modülü cihazınızda hemen çalıştırıp test edebilirsiniz.

Android Studio yeni modül için gerekli tüm dosyaları oluşturur ve projeyi yeni modül gradle dosyalarıyla senkronize eder. Yeni bir cihaz için modül eklemek, hedef cihaz için gerekli tüm bağımlılıkları da modülün derleme dosyasına ekler.

Gradle proje senkronizasyonu tamamlandıktan sonra, yeni modül soldaki Proje penceresinde görünür. Yeni modül klasörünü görmüyorsanız pencerede Android görünümü gösterildiğinden emin olun.

Modülü içe aktarma

Mevcut bir modülü projenize aktarmak için aşağıdaki adımları uygulayın:

  1. Dosya > Yeni > Modülü İçe Aktar'ı tıklayın.
  2. Kaynak dizin kutusuna, içe aktarmak istediğiniz modüllerin dizinini yazın veya seçin:
    • Bir modülü içe aktarıyorsanız kök dizinini belirtin.
    • Bir projeden birden fazla modülü içe aktarıyorsanız proje klasörünü belirtin. Klasörün içindeki her modül için Kaynak konumu ve Modül adı'nı belirten bir kutu görünür. İçe aktarmak istediğiniz her modül için İçe aktar kutusunun işaretli olduğundan emin olun.
    Modüllerinizin başka bağımlılıkları varsa bunlar içe aktarılmak üzere Gerekli ek modüller bölümünde listelenir.
  3. Modül adı alanlarına istediğiniz modül adlarını yazın.
  4. Son'u tıklayın.

Modül içe aktarıldıktan sonra soldaki Proje penceresinde görünür.

Sonraki adımlar

Yeni bir modül ekledikten sonra modül kodunu ve kaynakları değiştirebilir, modül derleme ayarlarını yapılandırabilir ve modülü derleyebilirsiniz. Ayrıca, modülü diğer uygulamalarda olduğu gibi çalıştırabilir ve hata ayıklayabilirsiniz.

Ayrıca, yeni cihazı doğru şekilde desteklemek için kod ve kaynaklar da eklemeniz gerekir. Farklı cihaz türleri için uygulama modülleri geliştirme hakkında daha fazla bilgi edinmek için ilgili dokümanlara bakın:

Yeni modülünüzü geliştirirken, farklı bir uygulama modülünde kopyalanmış cihazdan bağımsız bir kod oluşturabilirsiniz. Yinelenen kodu korumak yerine, paylaşılan kodu bir kitaplık modülüne taşımayı ve kitaplığı uygulama modüllerinize bağımlılık olarak eklemeyi düşünün. Kitaplık modülü oluşturma ve bunu bağımlılık olarak ekleme hakkında daha fazla bilgi için Android Kitaplığı oluşturma bölümüne bakın.