İlk Android uygulamanızı oluşturma ve çalıştırma

Bu codelab'de, Android Studio tarafından sağlanan temel bir uygulama şablonundan başlayarak ilk Android uygulamanızı (Happy Birthday) oluşturacaksınız. Ayrıca bir Android projesinin nasıl göründüğünü keşfedecek ve Android Studio'da farklı pencereleri nasıl kullanacağınızı öğreneceksiniz.

Ön koşullar

• Kelime işlemci veya e-tablo gibi uygulamaları kurma, yapılandırma ve kullanma konusunda bilgi sahibi olma

Neler öğreneceksiniz?

• Şablon kullanarak Android uygulaması için Android Studio projesi oluşturma

Ne oluşturacaksınız?

• Şablondan oluşturulan temel bir Android uygulaması

İhtiyacınız olanlar

• Android Studio yüklü bir bilgisayar

Bu görevde, Android Studio tarafından sağlanan bir proje şablonunu kullanarak Android uygulaması oluşturacaksınız.

Proje şablonları

Android Studio'da proje şablonu, gerekli tüm parçaları içeren ancak çok fazla işlem yapmayan bir Android uygulamasıdır. Bu şablonun amacı, daha hızlı bir başlangıç yapmanıza yardımcı olmak ve iş yükünüzü azaltmaktır. Android Studio'daki şablonlara örnek olarak harita içeren bir uygulama ve birden fazla ekran içeren bir uygulama verilebilir.

Boş Etkinlik projesi oluşturma

Bu adımlarda, yeni uygulamanız için Empty Activity proje şablonunu kullanarak yeni bir Android Studio projesi oluşturacaksınız.

1. Android Studio simgesini tıklayarak Android Studio'yu başlatın (henüz açık değilse).

Android Studio'ya Hoş Geldiniz penceresi gösterilir.

2. Welcome to Android Studio (Android Studio'ya Hoş Geldiniz) penceresinde + Start a new Android Studio project (+ Yeni bir Android Studio projesi başlat) seçeneğini tıklayın.

Android Studio tarafından sağlanan şablonların listesini içeren Yeni Proje Oluştur penceresi açılır.

3. Üstteki sekmeleri tıklayın ve şablonlar arasında gezinerek neler yapabileceğiniz hakkında fikir edinin. Birçok farklı cihaz türü (ör. telefonlar, tabletler ve kol saatleri) ve farklı uygulama türleri (kaydırılabilir ekranlara sahip uygulamalar, haritalı uygulamalar ve gelişmiş gezinme özellikli uygulamalar) için şablonlar vardır.
4. Pencerenin sol üst kısmındaki Telefon ve Tablet sekmesini tıklayın.
5. Üst satırda, Boş Etkinlik şablonunu tıklayarak projenizin şablonu olarak seçin.

Empty Activity (Boş Etkinlik) şablonu, uygulama oluşturmak için kullanılabilecek en basit şablondur. Tek bir ekrana sahiptir ve basit bir "Hello World!" (Merhaba Dünya!) mesajı görüntüler.

6. Pencerenin alt kısmında Sonraki'yi tıklayın. Yeni Proje Oluştur iletişim kutusu açılır.

Projenizi aşağıdaki gibi yapılandırın:

7. Ad, uygulamanızın adıdır. Ad'ın altındaki kutuya projenizin adı olarak Happy Birthday girin.
8. Paket adı, Android sisteminin uygulamanızı benzersiz şekilde tanımlamak için kullandığı addır. Genellikle, bu ad varsayılan olarak kuruluşunuzun adını ve ardından uygulamanın adını içerir. Tüm adlar küçük harflerle yazılır (bu örnekte "com.example.happybirthday").
9. Kaydetme konumu, projenizle ilgili tüm dosyaların kaydedildiği konumdur. Dosyalarınızı bulabilmek için bilgisayarınızda bu konumun neresi olduğunu not edin. Kaydetme konumunu da şimdilik olduğu gibi bırakabilirsiniz.
10. Dil, projenizde kullanmak istediğiniz programlama dilini tanımlar. Dil'in Kotlin olduğundan emin olun.
11. Minimum SDK, uygulamanızın üzerinde çalışabileceği minimum Android sürümünü gösterir. Açılır listeden API 19: Android 4.4 (KitKat) simgesini seçin.

Not: Android işletim sisteminin birçok farklı sürümü vardır. Bu sürümler, yayınlandıkça alfabetik sırayla adlandırılır.

12. Minimum SDK bölümünün altında, seçilen API düzeyiyle uygulamanızın kaç cihazda çalışabileceğiyle ilgili bilgilendirici notu inceleyin. Merak ediyorsanız aşağıdaki resimde gösterildiği gibi farklı Android sürümlerinin listesini görüntülemek için Seçmeme yardım et bağlantısını tıklayın. Ardından Yeni Proje penceresine dönün.

13. Yeni Proje Oluştur penceresinde Eski android.support kitaplıklarını kullan seçeneğinin işaretli olmadığından emin olun. Bu konu hakkında daha fazla bilgi edinmek istiyorsanız soru işaretini tıklayın.
14. Son'u tıklayın.

Android Studio, projeyi ve tüm dosyalarını açar.

Android Studio'yu ilk kez açtığınızda üç pencere görürsünüz:

(1) Proje penceresinde projenizin dosyaları ve klasörleri gösterilir.

(2) Düzenleme penceresi, kodu düzenlemek için kullanılır.

(3) Yenilikler penceresinde haberler ve faydalı ipuçları gösterilir.

Android Studio'nun sağ alt köşesinde, projenizi ayarlamaya devam edip etmediğini gösteren bir ilerleme çubuğu veya mesaj bulunur. Örneğin:

15. Android Studio'nun projenizi kurma işlemini tamamlamasını bekleyin. Proje tamamlandığında sol alt köşede aşağıdaki gibi bir mesaj gösterilir.

Bu görevde, mobil cihazın yazılım sürümünü (emülatör) oluşturmak ve bilgisayarınızda çalıştırmak için Android Sanal Cihaz (AVD) yöneticisini kullanacaksınız. Sanal cihaz veya emülatör, belirli bir Android cihaz türünün (ör. telefon) yapılandırmasını simüle eder. Bu, seçtiğiniz Android sistem sürümlerinin yüklü olduğu herhangi bir telefon veya tablet olabilir. Ardından, Empty Activity (Boş Etkinlik) şablonuyla oluşturduğunuz uygulamayı çalıştırmak için sanal cihazı kullanacaksınız.

Not: Android Emulator, sanal cihaz oluşturmak için kullanılan bağımsız bir uygulamadır ve kendi sistem gereksinimleri vardır. Sanal cihazlar çok fazla disk alanı kullanabilir. Herhangi bir sorunla karşılaşırsanız Android Emulator'da uygulamaları çalıştırma başlıklı makaleyi inceleyin.

Android sanal cihazı (AVD) oluşturma

Bilgisayarınızda bir emülatör çalıştırmaya yönelik ilk adım, sanal cihaz için bir yapılandırma oluşturmaktır.

1. Android Studio menü çubuğundan Tools > AVD Manager'ı (Araçlar > AVD Yöneticisi) seçin.

İpucu: AVD Yöneticisi'ni araç çubuğundaki simgesini tıklayarak da açabilirsiniz.

Sanal Cihazlarınız iletişim kutusu aşağıda gösterildiği gibi görüntülenir. (Daha önce sanal cihaz oluşturduysanız bu cihaz burada listelenir.)

2. + Sanal Cihaz Oluştur'u tıklayın.

Donanım Seç penceresi açılır.

Donanım Seç penceresinde, Kategori'ye göre düzenlenmiş ve aralarından seçim yapabileceğiniz önceden yapılandırılmış cihazların listesi gösterilir. Tabloda her cihaz için ekran boyutu (Boyut), piksel cinsinden ekran çözünürlüğü (Çözünürlük) ve piksel yoğunluğu (Yoğunluk) sütunları yer alır.

3. Kategori olarak Telefon'u seçin.
4. Bir telefon seçin (örneğin, Pixel 3 XL) ve Sonraki'yi tıklayın. Dilediğiniz telefonu seçebilirsiniz ancak bu codelab için daha yeni bir cihaz seçin.

Sistem görüntüsü penceresi görünür. Buradan, sanal cihazınızda çalıştırılacak Android sisteminin sürümünü seçersiniz. Bu sayede uygulamanızı Android sisteminin farklı sürümlerinde test edebilirsiniz.

5. Önerilen sekmesinde, sanal cihazda çalıştırılacak Android sistem sürümü olarak Q'ı seçin. Bu, yazıldığı sırada Android'in en son sürümüydü ancak daha sonraki kararlı sürümlerden herhangi birini seçebilirsiniz. Kararlı sürümlerin listesi için burayı inceleyin.

Not: Kullanmak istediğiniz bir sistem görüntüsünün yanında İndir bağlantısı görünüyorsa bu görüntü bilgisayarınızda yüklü değildir. Sanal cihaz yapılandırılmadan önce görüntüyü yüklemeniz gerekir.

Sistem görüntüsü yüklemek için İndir bağlantısını tıklayın. İndirme işleminin, internet bağlantınıza bağlı olarak uzun sürebileceğini unutmayın. İndirme işlemi tamamlandığında Son'u tıklayın.

Önemli: Bu Android sistem görüntüleri çok fazla disk alanı kullandığından orijinal yüklemenizde yalnızca birkaçı yer alır. Android sisteminin Önerilenler sekmesinde gösterilenden çok daha fazla sürümü mevcuttur. Bu resimleri görmek için x86 Resimleri ve Diğer Resimler sekmelerine bakın.

5. İleri'yi tıklayın.

Android Sanal Cihaz (AVD) penceresi gösterilir. Bu pencerede cihazınız için ek yapılandırma ayrıntıları seçebilirsiniz.

6. AVD Name (AVD Adı) alanına Android Sanal Cihazınız için bir ad girin. Geri kalanını değiştirmeden bırakın.
7. Son'u tıklayın.

Yeni sanal cihazınız Sanal Cihazınız penceresinde gösterilir ve kullanıma hazır olur.

8. Sanal Cihazınız penceresini kapatın.

Uygulamanızı sanal cihazda çalıştırma

1. Henüz ön planda değilse Android Studio'yu ön plana getirin.
2. Android Studio'daki araç çubuğunda sanal cihaz açılır menüsünü (aşağıdaki örneğe benzer) bulun ve açılır listeden oluşturduğunuz sanal cihazı seçin. (Alternatif olarak, Run > Select Device.. (Çalıştır > Cihaz Seç) seçeneğini tıklayın ve pop-up'taki kullanılabilir cihazlar arasından sanal cihazınızı seçin.)
3. Android Studio'da Run > Run app'i seçin veya araç çubuğunda Run simgesini [ICON HERE] tıklayın. [IMAGEINFO]: ic_run.png, Android Studio Run icon" style="width: 21.56px" src="img/609c3e4473493202.png"> simgesini tıklayın.
   Sanal cihaz, fiziksel bir cihaz gibi başlatılır ve açılır. Bilgisayarınızın hızına bağlı olarak bu işlem biraz zaman alabilir.

Uygulamanız hazır olduğunda aşağıdaki resimde gösterildiği gibi sanal cihazda açılır.

Tebrikler! Sanal cihazınız artık çalışır durumda. Başlığın artık "Happy Birthday" olduğunu ve ekranda "Hello World!" ifadesinin gösterildiğini fark edeceksiniz.

Projenizi yapılandırdığınızda Android Studio, bilgisayarınızda tüm Android projeleriniz için AndroidStudioProjects adlı bir klasör oluşturur. Android Studio, AndroidStudioProjects klasörünün içinde uygulamanızla aynı ada sahip bir klasör de oluşturur (bu örnekte HappyBirthday).

HappyBirthday klasörü, proje klasörünüzdür. Android Studio, hem oluşturduğunuz dosyaları hem de Android Studio tarafından oluşturulan dosyaları proje klasörünüze kaydeder.

1. Android Studio'da soldaki Project (Proje) penceresine bakın. Proje penceresinde projenizin dosyaları ve klasörleri gösterilir.

Proje penceresindeki dosyalar, kod yazarken proje dosyaları arasında gezinmeyi kolaylaştıracak şekilde düzenlenir. Ancak dosyaları Finder veya Windows Gezgini gibi bir dosya tarayıcısında incelerseniz dosya hiyerarşisinin çok farklı şekilde düzenlendiğini görürsünüz.

Bu görevde, proje klasörü hiyerarşisinin bu iki farklı görünümünü keşfedeceksiniz.

2. Android Studio'daki Project (Proje) penceresinde, sol üst köşedeki açılır menüden Android'i seçin.

Aşağıdakine benzer bir dosya listesi görmeniz gerekir:

Bu görünüm ve dosya düzeni, projeniz için kod yazarken işinize yarar.

Dosyalarınızı, Finder (macOS için) veya Explorer (Windows için) gibi bir dosya tarayıcısında görünecekleri şekilde de görüntüleyebilirsiniz.

3. Proje penceresinde, açılır menüden Proje Kaynak Dosyaları'nı seçin.

Başlığın, proje dosyalarının depolandığı klasör olarak değiştiğini fark edin.

Artık dosyalara herhangi bir dosya gezgininde olduğu gibi göz atabilirsiniz.

4. Önceki görünüme geri dönmek için Proje penceresinde tekrar Android'i seçin.

Mükemmel! Artık şablondan uygulama oluşturup çalıştırabilir ve proje dosyalarınızı bulabilirsiniz.

• Yeni bir proje oluşturmak için Android Studio'yu başlatın, + Yeni bir Android Studio projesi başlat'ı tıklayın, projenize ad verin, bir şablon seçin ve ayrıntıları girin.
• Uygulamanızı çalıştırmak için Android sanal cihazı (emülatör) oluşturmak üzere Tools > AVD Manager'ı seçin ve donanım cihazı ile sistem görüntüsü seçmek için AVD Manager'ı kullanın.
• Uygulamanızı sanal bir cihazda çalıştırmak için cihaz oluşturduğunuzdan emin olun, araç çubuğu açılır menüsünden cihazı seçin ve ardından Çalıştır simgesini tıklayarak uygulamanızı çalıştırın veya araç çubuğundaki Çalıştır simgesini [ICON HERE] tıklayın. Araç çubuğunda [IMAGEINFO]: ic_run.png, Android Studio Run icon" style="width: 20.00px" src="img/609c3e4473493202.png"> simgesini tıklayın.
• Proje dosyalarınızı bulmak için Proje penceresinde açılır listeden Proje Kaynak Dosyaları'nı seçin.

• Android Studio ile tanışın
• Projelere genel bakış
• Proje oluşturma
• Şablondan kod ekleme
• Uygulamanızı derleyip çalıştırma
• Uygulamaları Android emülatörde çalıştırma