Bu sayfa, Cloud Translation API ile çevrilmiştir.

Android Kotlin Hakkında Temel Bilgiler 01.1: Başlangıç

Bu codelab, Android Kotlin Hakkında Temel Bilgiler kursunun bir parçasıdır. Bu kurstan en iyi şekilde yararlanmak için codelab'leri sırayla tamamlamanızı öneririz. Kursla ilgili tüm codelab'ler Android Kotlin Hakkında Temel Bilgiler codelab'leri açılış sayfasında listelenir.

Giriş

Bu codelab'de ilk Android uygulamanız olan HelloWorld'ü bir emülatörde ve fiziksel bir cihazda oluşturup çalıştıracaksınız. Ayrıca bir Android projesinin nasıl göründüğünü de keşfedersiniz.

Bilmeniz gerekenler

Android Studio gibi bir IDE (entegre geliştirme ortamı) kullanarak nesne yönelimli uygulamalar için genel yazılım geliştirme sürecini anlamanız gerekir.
Nesne yönelimli programlama konusunda en az bir yıl deneyimli olmalı, Java ve Kotlin hakkında bilgi sahibi olmalısınız.

Neler öğreneceksiniz?

Android Studio'da temel bir Android uygulaması oluşturma
Şablondan Android projesi oluşturma
Android projesinin ana bileşenlerini bulma
Android uygulamasını emülatörde veya fiziksel cihazda çalıştırma

Yapacaklarınız

Yeni bir Android projesi ve HelloWorld adlı varsayılan bir uygulama oluşturun.
Uygulamanızı bilgisayarınızda çalıştırabilmek için bir emülatör (sanal cihaz) oluşturun.
HelloWorld uygulamasını sanal ve fiziksel cihazlarda çalıştırın.
Proje düzenini keşfedin.
AndroidManifest.xml dosyasını inceleyin.

HelloWorld uygulaması, Android sanal cihazının veya fiziksel cihazın ekranında "Hello World" dizesini gösterir. Uygulamanın görünümü aşağıdaki gibidir:

Bu görevde, Android Studio'nun doğru şekilde yüklendiğini doğrulamak için yeni bir uygulama projesi oluşturacaksınız.

Henüz açılmadıysa Android Studio'yu açın.
Ana Android Studio'ya Hoş Geldiniz iletişim kutusunda Yeni bir Android Studio projesi başlat'ı tıklayın.
Projenizi seçin iletişim kutusu görünür. Aşağıda gösterildiği gibi Empty Activity'yi (Boş Etkinlik) seçin ve Next'i (Sonraki) tıklayın.

Activity, kullanıcının yapabileceği tek ve odaklanılmış bir şeydir. Her uygulamanın giriş noktası olarak en az bir etkinliği olmalıdır. Bu giriş noktası etkinliğini diğer programlardaki main() işlevi olarak düşünebilirsiniz. Bir etkinliğin genellikle kullanıcı arayüzü (UI) öğelerinin ekranda nasıl görüneceğini tanımlayan bir düzeni vardır. Android Studio, Activity başlamanıza yardımcı olacak çeşitli şablonlar
sunar.
Projenizi yapılandırın iletişim kutusunda Ad için "HelloWorld" yazın.
Şirket alanı için varsayılan android.example.com'u kabul edin veya benzersiz bir şirket alanı oluşturun. Bu değer ve uygulamanın adı, uygulamanızın paket adıdır. Uygulamanızı yayınlamayı planlamıyorsanız varsayılanı kabul edin. Uygulamanızın paket adını daha sonra değiştirebilirsiniz ancak bu ek bir çalışmayı gerektirir.
Varsayılan kaydetme konumunun uygulamanızı depolamak istediğiniz yer olduğunu doğrulayın. Değilse konumu tercih ettiğiniz dizin olarak değiştirin.
Dil'in Kotlin olduğundan emin olun.
Minimum API düzeyinin API 19: Android 4.4 (KitKat) olduğundan emin olun. Bu codelab yazıldığında Android Studio, bu API düzeyiyle uygulamanın cihazların yaklaşık% 95, 3'ünde çalışacağını belirtiyordu.
(Minimum API düzeyleri hakkında daha fazla bilgiyi sonraki bir codelab'de öğreneceksiniz. Daha fazla bilgi edinmek için Seçim yapmama yardım et'i tıklayın. Bu seçenek, API düzeyleri hakkında bilgi içeren bir pencere açar.)
AndroidX yapılarını kullan onay kutusunu işaretleyin.
Diğer tüm onay kutularını temiz bırakın ve Bitir'i tıklayın. Projeniz, seçtiğiniz hedef SDK için daha fazla bileşen gerektiriyorsa Android Studio bunları otomatik olarak yükler. Bu işlem biraz zaman alabilir. Talimatları uygulayın ve varsayılan seçenekleri kabul edin.

Android Studio artık projenizi oluşturuyor. Bu işlem biraz zaman alabilir. Herhangi bir hata almamalısınız. Uyarı alırsanız bunları yoksayın.

Bu görevde, Android Studio'daki HelloWorld projesini keşfedecek ve Android Studio ile geliştirme yapmanın temellerini öğreneceksiniz.

1. adım: Proje bölmesini keşfedin

Proje sekmesi seçili değilse bu sekmeyi seçin. Proje sekmesi, Android Studio penceresinin sol tarafındaki dikey sekme sütununda yer alır. Proje bölmesi açılır.
Projeyi standart bir Android proje hiyerarşisi olarak görüntülemek için Proje bölmesinin üst kısmındaki açılır menüden Android'i seçin. (Varsayılan olarak Android seçilidir.) Proje dosyalarını, dosya sistemi hiyerarşisinde göründükleri şekilde görüntülemek de dahil olmak üzere birçok farklı şekilde inceleyebilirsiniz. Ancak Android görünümü kullanılarak projede çalışmak daha kolaydır.

2. adım: Uygulama klasörünü keşfedin

Uygulamanızla ilgili tüm kod ve kaynaklar app klasöründe bulunur.

Project > Android (Proje > Android) bölmesinde app klasörünü genişletin. app klasöründe dört alt klasör bulunur: manifests, java, generatedJava ve res.
java klasörünü ve ardından com.example.android.HelloWorld klasörünü genişleterek MainActivity Kotlin dosyasını görün.

java klasörü, bir Android uygulaması için tüm ana Kotlin kodunu içerir. Kotlin kodunuzun java klasöründe görünmesinin geçmişe dayalı nedenleri vardır. Bu kural, Kotlin'in aynı proje ve uygulamada bile Java programlama dilinde yazılmış kodla sorunsuz bir şekilde birlikte çalışmasına olanak tanır.

Uygulamanızın sınıf dosyaları, yukarıdaki şekilde gösterildiği gibi üç alt klasörde bulunur. com.example.hello.helloworld (veya belirttiğiniz alan adı) klasörü, bir uygulama paketine ait tüm dosyaları içerir. Özellikle MainActivity sınıfı, uygulamanızın ana giriş noktasıdır. MainActivity hakkında daha fazla bilgiyi sonraki codelab'de edinebilirsiniz. java klasöründeki diğer iki klasör, birim testleri gibi testle ilgili kodlar için kullanılır.

generatedJava klasörünü not edin. Bu klasör, Android Studio'nun uygulamayı oluştururken oluşturduğu dosyaları içerir. Bu klasördeki hiçbir şeyi düzenlemeyin. Aksi takdirde, uygulamayı yeniden oluşturduğunuzda değişikliklerinizin üzerine yazılabilir. Ancak hata ayıklama sırasında bu dosyalara bakmanız gerektiğinde bu klasör hakkında bilgi sahibi olmanız faydalı olur.

3. adım: res klasörünü keşfedin

Project > Android (Proje > Android) bölmesinde res klasörünü genişletin.

res klasöründe kaynaklar bulunur. Android'deki kaynaklar, uygulamalarınızda kullanılan statik içeriklerdir. Kaynaklar arasında resimler, metin dizeleri, ekran düzenleri, stiller ve onaltılık renkler veya standart boyutlar gibi değerler yer alır.

Android uygulamaları, Kotlin kodunu ve kaynaklarını mümkün olduğunca ayırır. Bu sayede, uygulamanın kullanıcı arayüzünde kullanılan tüm dizeleri veya simgeleri bulmak çok daha kolay olur. Ayrıca, bu kaynak dosyalarından birini değiştirdiğinizde değişiklik, dosyanın uygulamada kullanıldığı her yerde geçerli olur.
res klasöründe, activity_main.xml dosyasını görmek için layout klasörünü genişletin.

Activity genellikle res/layout dizininde XML dosyası olarak tanımlanan bir kullanıcı arayüzü düzen dosyasıyla ilişkilendirilir. Bu düzen dosyası genellikle etkinliğine göre adlandırılır. Bu durumda etkinlik adı MainActivity olduğundan ilişkili düzen activity_main olur.

4. adım: Manifests klasörünü ve AndroidManifest.xml'i inceleyin

manifests klasörü, Android sistemine uygulamanızla ilgili temel bilgileri sağlayan dosyaları içerir.

Manifestler klasörünü genişletin ve AndroidManifest.xml dosyasını çift tıklayarak açın. AndroidManifest.xml dosyası, Android sisteminin uygulamanızı çalıştırmak için ihtiyaç duyduğu ayrıntıları (ör. uygulamada yer alan etkinlikler) içerir.
MainActivity öğesinin <activity> öğesinde referans verildiğini unutmayın. Uygulamanızdaki tüm Activity manifestte beyan edilmelidir. MainActivity için bir örnek:

<activity android:name=".MainActivity">
   <intent-filter>
       <action android:name="android.intent.action.MAIN"/>

       <category android:name="android.intent.category.LAUNCHER"/>
   </intent-filter>
</activity>

<activity> içindeki <intent-filter> öğesine dikkat edin. Bu amaç filtresindeki <action> ve <category> öğeleri, kullanıcı başlatıcı simgesini tıkladığında Android'e uygulamayı nereden başlatacağını söyler. Niyet filtreleri hakkında daha fazla bilgiyi sonraki bir codelab'de edinebilirsiniz.

AndroidManifest.xml dosyası, uygulamanızın ihtiyaç duyduğu izinleri tanımlayacağınız yerdir. İzinler arasında uygulamanızın telefon kişilerini okuma, internet üzerinden veri gönderme veya cihazın kamerası gibi donanımlara erişme özelliği yer alır.

Gradle, uygulamanın proje yapısını, yapılandırmasını ve bağımlılıklarını açıklamak için alana özgü bir dil kullanan bir derleme otomasyon sistemidir. Uygulamanızı derleyip çalıştırdığınızda, çalışan Gradle derlemesiyle ilgili bilgileri görürsünüz. Ayrıca, yüklenen Android Paket Kiti (APK) hakkında da bilgi görürsünüz. (APK, Android işletim sisteminin mobil uygulamaları dağıtmak ve yüklemek için kullandığı paket dosya biçimidir.)

Gradle sistemini keşfedin:

Gradle Scripts (Gradle Komut Dosyaları) klasörünü genişletin. Project > Android (Proje > Android) bölmesinde, bu klasörde derleme sisteminin ihtiyaç duyduğu tüm dosyalar bulunur.
build.gradle(Project: HelloWorld) dosyasını bulun.

Bu dosya, projenizi oluşturan tüm modüller için ortak olan yapılandırma seçeneklerini içerir. Her Android Studio projesi tek bir üst düzey Gradle derleme dosyası içerir. Bu dosya, projedeki tüm modüller için ortak olan Gradle depolarını ve bağımlılıklarını tanımlar.
build.gradle(Module:app) dosyasını bulun.

Proje düzeyindeki build.gradle dosyasına ek olarak her modülün kendi build.gradle dosyası vardır. Modül düzeyindeki build.gradle dosyası, her modül için derleme ayarlarını yapılandırmanıza olanak tanır. (HelloWorld uygulamasında yalnızca bir modül vardır: uygulamanın kendisi için olan modül.) Bu build.gradle dosyası, uygulama düzeyindeki derleme yapılandırmalarını değiştirirken en sık düzenlediğiniz dosyadır. Örneğin, uygulamanızın desteklediği SDK düzeyini değiştirdiğinizde veya dependencies bölümünde yeni bağımlılıklar bildirdiğinizde bu build.gradle dosyasını düzenlersiniz. Bu iki konu hakkında daha fazla bilgiyi sonraki bir codelab'de edinebilirsiniz.

Bu görevde, sanal cihaz (emülatör) oluşturmak için Android sanal cihaz (AVD) yöneticisini kullanacaksınız. Sanal cihaz, belirli bir Android cihaz türünün yapılandırmasını simüle eder. Ardından, uygulamayı çalıştırmak için bu sanal cihazı kullanırsınız.

Android Emulator 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.

1. adım: Android sanal cihazı (AVD) oluşturun

Bilgisayarınızda bir emülatör çalıştırmak için sanal cihazı açıklayan bir yapılandırma oluşturmanız gerekir.

Android Studio'da Tools > AVD Manager'ı seçin veya araç çubuğunda AVD Manager simgesini tıklayın. Sanal Cihazlarınız iletişim kutusu gösterilir. Daha önce sanal cihaz oluşturduysanız iletişim kutusunda bu cihazlar gösterilir (aşağıdaki şekilde gösterildiği gibi). Aksi takdirde boş bir liste görürsünüz.
İletişim kutusunun sol alt kısmında +Sanal Cihaz Oluştur'u tıklayın. Önceden yapılandırılmış donanım cihazlarının listesini gösteren Donanım Seç iletişim kutusu görünür. Tabloda her cihaz için köşegen 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.
Nexus 5x veya Pixel XL gibi bir cihaz seçin ve Sonraki'yi tıklayın. Sistem görüntüsü iletişim kutusu gösterilir.
Önerilen sekmesini tıklayın ve sanal cihazda hangi Android sistemi sürümünün (ör. Pie) çalıştırılacağını seçin.

Bir sistem görüntüsü seçtikten sonra Sonraki'yi tıklayın. Android Sanal Cihaz (AVD) iletişim kutusu açılır. Yapılandırmanızı kontrol edin ve Son'u tıklayın.

2. adım: Uygulamayı sanal cihazda çalıştırın

Bu görevde, yeni uygulamanızı nihai olarak çalıştırırsınız.

Android Studio'da Run > Run app'i seçin veya araç çubuğunda Run simgesini tıklayın. Araç çubuğunda [IMAGEINFO]: ic_run.png, Android Studio Run icon" style="width: 24.00px" src="img/6c65750f2ce7f651.png"> seçeneğini tıklayın. Dağıtım Hedefini Seçin iletişim kutusu görünür ve kullanılabilir cihaz olmadığını belirten bir uyarı gösterir. Geliştirme bilgisayarınıza bağlı fiziksel bir cihazınız yoksa veya henüz sanal bir cihaz başlatmadıysanız bu uyarıyı görürsünüz.
Select Deployment Target (Dağıtım Hedefini Seç) iletişim kutusundaki Available Virtual Devices (Kullanılabilir Sanal Cihazlar) bölümünde, oluşturduğunuz sanal cihazı seçin. Tamam'ı tıklayın.

Emülatör, fiziksel bir cihaz gibi başlatılır ve açılır. Bu işlem, bilgisayarınızın hızına bağlı olarak biraz zaman alabilir. Uygulamanız derlenir ve emülatör hazır olduğunda Android Studio, uygulama APK'sını emülatöre yükleyip çalıştırır.

Aşağıdaki şekilde gösterildiği gibi HelloWorld uygulamasını görmeniz gerekir.

Bu görevde, varsa uygulamanızı telefon veya tablet gibi fiziksel bir mobil cihazda çalıştırırsınız. Uygulamalarınızı her zaman hem sanal hem de fiziksel cihazlarda test edin.

Gerekenler:

Telefon veya tablet gibi bir Android cihaz.
Android cihazınızı USB bağlantı noktası üzerinden bilgisayarınıza bağlamak için USB veri kablosu.
Linux veya Windows sistemi kullanıyorsanız ek adımlar uygulamanız gerekebilir. Uygulamaları donanım cihazında çalıştırma başlıklı dokümanı inceleyin. Cihazınız için uygun USB sürücüsünü de yüklemeniz gerekebilir. Windows tabanlı USB sürücüleri için OEM USB sürücülerini yükleme başlıklı makaleyi inceleyin.

1. adım: USB üzerinden hata ayıklama ayarını açın

Android Studio'nun Android cihazınızla iletişim kurabilmesi için cihazın Geliştirici seçenekleri ayarlarında USB hata ayıklamayı etkinleştirmeniz gerekir.

Android 4.2 (Jellybean) ve sonraki sürümlerde Geliştirici seçenekleri ayarları varsayılan olarak gizlidir. Geliştirici seçeneklerini göstermek ve USB hata ayıklamayı etkinleştirmek için:

Cihazınızda Ayarlar'ı açın, Telefon hakkında'yı arayın, Telefon hakkında'ya ve Derleme numarası'na yedi kez dokunun.
Önceki sayfaya (Ayarlar / Sistem) dönün. Listede Geliştirici seçenekleri gösterilir. Geliştirici seçenekleri'ne dokunun.
USB üzerinden hata ayıklama'yı seçin.

2. adım: Uygulamanızı Android cihazda çalıştırın

Artık cihazınızı bağlayabilir ve uygulamayı Android Studio'dan çalıştırabilirsiniz.

Android cihazı bir USB kablosuyla geliştirme makinenize bağlayın. Cihazda, USB hata ayıklamaya izin vermenizi isteyen bir iletişim kutusu görünür.
Bu bilgisayarı hatırlamak için Her zaman izin ver seçeneğini belirleyin. Tamam'a dokunun.
Bilgisayarınızda, Android Studio araç çubuğunda Çalıştır düğmesini tıklayın. Kullanılabilir emülatörlerin ve bağlı cihazların listesini içeren Select Deployment Target (Dağıtım Hedefini Seç) iletişim kutusu açılır. Fiziksel cihazınızın yanı sıra tüm emülatörleri görmeniz gerekir.
Cihazınızı seçin ve Tamam'ı tıklayın. Android Studio, uygulamayı cihazınıza yükler ve çalıştırır.

Sorun giderme

Android Studio cihazınızı tanımıyorsa şunları deneyin:

USB kablosunu çıkarıp tekrar takın.
Android Studio'yu yeniden başlatın.

Bilgisayarınız cihazı hâlâ bulamıyorsa veya "yetkisiz" olarak bildiriyorsa aşağıdaki adımları uygulayın:

USB kablosunu çıkarın.
Cihazda Ayarlar uygulamasında Geliştirici seçenekleri'ni açın.
USB hata ayıklama yetkilerini kaldır'a dokunun.
Cihazı bilgisayarınıza yeniden bağlayın.
İstendiğinde yetkilendirme verin.

Cihazınız için uygun USB sürücüsünü yüklemeniz gerekebilir. Uygulamaları donanım cihazında çalıştırma başlıklı makaleyi inceleyin.

Zorluk: Kurulumu tamamlayıp temel geliştirme iş akışına alıştıktan sonra aşağıdakileri yapın:

Android Studio'da yeni bir proje oluşturun.
"Merhaba Dünya" karşılama mesajını "Doğum günün kutlu olsun " ve doğum günü yakın olan birinin adıyla değiştirin.

Android Studio'yu yüklemek için Android Studio'ya gidip indirme ve yükleme talimatlarını uygulayın.
Bir uygulamanın Android hiyerarşisini Proje bölmesinde görmek için dikey sekme sütununda Proje sekmesini tıklayın. Ardından üstteki açılır menüden Android'i seçin.
Projenize yeni bağımlılıklar eklemeniz veya bağımlılık sürümlerini değiştirmeniz gerektiğinde build.gradle(Module:app) dosyasını düzenleyin.
Bir uygulamaya ait tüm kod ve kaynaklar app ve res klasörlerinde bulunur. java klasörü, Kotlin veya Java kaynak kodundaki (ya da her ikisindeki) etkinlikleri, testleri ve diğer bileşenleri içerir. res klasöründe düzenler, dizeler ve resimler gibi kaynaklar bulunur.
Android uygulamanıza özellikler, bileşenler ve izinler eklemek için AndroidManifest.xml dosyasını düzenleyin. Ek etkinlikler gibi tüm uygulama bileşenleri bu XML dosyasında bildirilmelidir.
Uygulamanızı çalıştırmak için Android sanal cihazı (emülatör) oluşturmak üzere AVD Manager'ı kullanın.
Android Studio'yu kullanarak uygulamanızı fiziksel bir Android cihazda çalıştırmak için cihazda USB hata ayıklamayı etkinleştirin. Bunu yapmak için Ayarlar > Telefon hakkında'yı açın ve Derleme numarası'na yedi kez dokunun. Ardından Ayarlar > Geliştirici seçenekleri'ni açıp USB üzerinden hata ayıklama'yı seçin.

Udacity kursu:

Kotlin ile Android Uygulamaları Geliştirme

Android Studio dokümanları:

Diğer:

Bu bölümde, bir eğitmenin yönettiği kurs kapsamında bu codelab'i tamamlayan öğrenciler için olası ödevler listelenmektedir. Eğitmen, aşağıdakileri yapmalıdır:

Gerekirse ödev atayın.
Öğrencilere ev ödevi ödevlerini nasıl göndereceklerini bildirin.
Ödevlere not verin.

Eğitmenler bu önerileri istedikleri kadar kullanabilir ve uygun olduğunu düşündükleri diğer ödevleri verebilirler.

Bu codelab'i kendi başınıza tamamlıyorsanız bilginizi test etmek için bu ödevleri kullanabilirsiniz.

Uygulama oluşturma ve çalıştırma

Boş şablondan yeni bir Android projesi oluşturun.
res/strings.xml dosyasını açın.
app_name dizesinin değerini "My Dice Roller" olarak değiştirin. Bu ad, başlık çubuğunda görünür.
İstediğiniz Android sürümünü hedefleyen bir cihaz için emülatör oluşturun ve uygulamayı çalıştırın. Uygulamanın başlığının nasıl değiştiğine dikkat edin.

Bu soruları yanıtlayın

1. Soru

Ana etkinliğin düzen dosyasının adı nedir?

MainActivity.java
AndroidManifest.xml
activity_main.xml
build.gradle

2. Soru

Uygulamanın adını belirten dize kaynağının adı nedir?

app_name
xmlns:app
android:name
applicationId

3. Soru

Yeni bir emülatör oluşturmak için hangi aracı kullanıyorsunuz?

Android Device Monitor
AVD Yöneticisi
SDK Manager
Tema Düzenleyici

Uygulamanızı notlandırmaya gönderme

Uygulamada aşağıdakilerin bulunduğundan emin olun:

Ekranda "Hello World" yazan bir Activity.
"Zar Atma Uygulamam" yazan bir başlık çubuğu.

Bir sonraki derse başlayın: 1.2: Temel uygulama anatomisi

Bu kurstaki diğer codelab'lerin bağlantılarını Android Kotlin Hakkında Temel Bilgiler codelab'leri açılış sayfasında bulabilirsiniz.