Proje oluştur

Android Studio, telefonlar, tabletler, TV'ler ve Wear cihazlar gibi çeşitli form faktörleri için Android uygulamaları oluşturmayı kolaylaştırır. Bu sayfada, yeni bir Android uygulama projesine nasıl başlanacağı veya mevcut bir projenin nasıl içe aktarılacağı açıklanmaktadır.

Açık bir projeniz yoksa Android Studio karşılama ekranında New Project'i (Yeni Proje) tıklayarak yeni bir proje oluşturun.

Açık bir projeniz varsa ana menüden Dosya > Yeni > Yeni Proje'yi seçerek yeni bir proje oluşturun.

Proje türünüzü seçin

Açılan Yeni Proje ekranında, Şablonlar bölmesinde gösterilen cihaz form faktörü kategorilerinden oluşturmak istediğiniz proje türünü seçebilirsiniz. Örneğin, Şekil 1'de telefon ve tablet için proje şablonları gösterilmektedir.

Şekil 1. Yeni Proje ekranında oluşturmak istediğiniz proje türünü seçin.

Oluşturmak istediğiniz proje türünü seçtiğinizde Android Studio, başlamanıza yardımcı olmak için projenize örnek kod ve kaynaklar ekler.

Compose projelerinde, tüm yeni projeler için önerilen başlangıç noktası Empty Activity'dir. Modern ve bildirimsel bir temel sağlayan bu kitaplık, Compose bağımlılıklarını ve Materyal Tasarım kurulumunu içerir. Diğer şablonları yalnızca eski bir kod tabanını koruyorsanız veya taşıyorsanız kullanın.

Proje türünüzü seçtikten sonra Sonraki'yi tıklayın.

Projenizi yapılandırın

Projenizi oluşturmanın bir sonraki adımı, Şekil 2'de gösterildiği gibi bazı ayarları yapılandırmaktır. Native C++ projesi oluşturuyorsanız yapılandırmanız gereken seçenekler hakkında daha fazla bilgi edinmek için C/C++ desteğiyle yeni bir proje oluşturma başlıklı makaleyi inceleyin.

Yeni projenizi birkaç ayarla yapılandırın.
Şekil 2. Yeni projenizi birkaç ayarla yapılandırın.
  1. Projenizin Adı'nı belirtin.
  2. Paket adını belirtin. Varsayılan olarak bu paket adı, projenizin ad alanı (proje kaynaklarınıza erişmek için kullanılır) ve projenizin uygulama kimliği (yayınlama için kimlik olarak kullanılır) olur. Daha fazla bilgi edinmek için Uygulama modülünü yapılandırma başlıklı makaleyi inceleyin.
  3. Projenizi yerel olarak depolamak istediğiniz kaydetme konumunu belirtin.

  4. Android Studio'nun yeni projeniz için örnek kod oluştururken kullanmasını istediğiniz Dili seçin. Kotlin, önerilen dildir ve Jetpack Compose gibi modern çerçeveler için gereklidir. Java desteklenir ancak yeni projeler için önerilmez.

  5. Uygulamanızın desteklemesini istediğiniz Minimum API düzeyi'ni seçin. Daha düşük bir API düzeyi seçtiğinizde uygulamanız, modern Android API'lerinin birçoğunu kullanamaz. Ancak Android cihazların daha büyük bir yüzdesi uygulamanızı çalıştırabilir. Daha yüksek bir API düzeyi seçildiğinde ise bunun tam tersi geçerlidir.

    Karar vermenize yardımcı olacak daha fazla veri görmek istiyorsanız Seçim yapmama yardım et'i tıklayın. Bu, seçtiğiniz API düzeyinin kümülatif dağılımını gösteren bir iletişim kutusu görüntüler ve farklı minimum API düzeyleri kullanmanın etkisini görmenizi sağlar.

    Farklı API seviyelerinin kümülatif dağılımını gösteren bir yardımcı.
    Şekil 3. Farklı API düzeylerinin kümülatif dağılımını gösteren bir yardım ekranı.
  6. Projeniz, Android Destek Kitaplıklarının yerini alan AndroidX kitaplıklarını varsayılan olarak kullanacak şekilde yapılandırılmış. Bunun yerine eski destek kitaplıklarını kullanmak için Eski android.support kitaplıklarını kullan'ı seçin. Ancak eski destek kitaplıkları artık desteklenmediği için bu işlem önerilmez. Daha fazla bilgi için AndroidX'e genel bakış başlıklı makaleyi inceleyin.

  7. Projenizi oluşturmaya hazır olduğunuzda Bitir'i tıklayın.

Android Studio, yeni projenizi oluştururken başlamanıza yardımcı olacak bazı temel kodlar ve kaynaklar ekler. Daha sonra farklı bir cihaz form faktörü için destek eklemeye karar verirseniz projenize modül ekleyebilirsiniz. Ayrıca modüller arasında kod ve kaynak paylaşmak isterseniz Android kitaplığı oluşturarak bunu yapabilirsiniz.

Android proje yapısı ve modül türleri hakkında daha fazla bilgi için Projelere genel bakış başlıklı makaleyi inceleyin. Android geliştirmeye yeni başlıyorsanız Android'i kullanmaya başlama başlıklı makaleyi inceleyin.

Mevcut bir projeyi içe aktarma

Mevcut bir yerel projeyi Android Studio'ya aktarmak için aşağıdaki adımları uygulayın:

  1. Dosya > Yeni > Projeyi İçe Aktar'ı tıklayın.
  2. Açılan pencerede, içe aktarmak istediğiniz projenin kök dizinine gidin.
  3. Tamam'ı tıklayın.

Android Studio, projeyi yeni bir IDE penceresinde açar ve içeriğini indeksler.

Sürüm denetiminden bir proje içe aktarıyorsanız Dosya > Yeni > Sürüm Denetiminden Proje'yi seçin. Sürüm denetiminden proje içe aktarma hakkında daha fazla bilgi için IntelliJ'in sürüm denetimi ile ilgili bilgilerine bakın.

Uygulamanızı derleyip çalıştırma

Projenizi oluşturduktan sonraki adım, projeyi oluşturup sanal veya fiziksel bir cihazda çalıştırmaktır. Android Studio, başlamanıza yardımcı olmak için varsayılan bir çalıştırma yapılandırması oluşturur.

Daha fazla bilgi için Uygulamanızı oluşturma ve çalıştırma başlıklı makalenin yanı sıra Android Emulator ve fiziksel donanım cihazlarında çalıştırmayı kapsayan kılavuzları inceleyin.