Temel bir etkileşimli zar atma uygulaması oluşturma

Bu codelab'de, kullanıcıların zar atmak için uygulamadaki Button simgesini tıklayabileceği bir Zar Atma Android uygulaması oluşturacaksınız. Zarın sonucu ekranda TextView içinde gösterilir.

Uygulama düzeninizi oluşturmak için Android Studio'daki Layout Editor'ü kullanacak, ardından Button simgesi tıklandığında ne olacağına dair Kotlin kodu yazacaksınız.

Ön koşullar

• Android Studio'da "Hello, World!" uygulaması oluşturma ve çalıştırma
• Uygulamalarda TextViews ve ImageViews kullanımına aşina olmalısınız.
• Düzenleyici'de bir TextView öğesinin özelliklerini değiştirme
• Uygulamanızı çevirmeyi ve dizeleri yeniden kullanmayı kolaylaştırmak için metni dize kaynağına nasıl ayıklayacağınızı öğrenin.
• Önceki codelab'lerde öğretilen Kotlin programlamanın temelleri.

Neler öğreneceksiniz?

• Android uygulamasına Button ekleme
• Uygulamada Button simgesine dokunulduğunda gerçekleşecek davranışı ekleme.
• Bir uygulamanın Activity kodunu açma ve değiştirme
• Toast mesajı görüntüleme
• Uygulama çalışırken TextView içeriğini güncelleme

Ne oluşturacaksınız?

• Zar atmak için Button simgesine dokunulduğunda zar atan ve ekrandaki metni zar atma sonucuna göre güncelleyen bir Zar Atma Android uygulaması.

İhtiyacınız olanlar

• Android Studio'nun yüklü olduğu bir bilgisayar.

Bu codelab'i tamamladığınızda uygulamanın görünümü aşağıdaki gibi olacaktır.

Boş Etkinlik projesi oluşturma

1. Android Studio'da açık bir projeniz varsa Yeni Proje Oluştur ekranını açmak için Dosya > Yeni > Yeni Proje... seçeneğine gidin.
2. Create New Project (Yeni Proje Oluştur) bölümünde, Empty Activity (Boş Etkinlik) şablonunu kullanarak yeni bir Kotlin projesi oluşturun.
3. Minimum API düzeyi 19 (KitKat) olan "Dice Roller" (Zar Atma) adlı bir uygulama oluşturun.

Önemli: Android Studio'da yeni proje oluşturma konusunda bilginiz yoksa ayrıntılar için İlk Android uygulamanızı oluşturma ve çalıştırma başlıklı makaleyi inceleyin.

4. Yeni uygulamayı çalıştırın. Uygulama şu şekilde görünmelidir.
   

Layout Editor'ü açma

1. Proje penceresinde, activity_main.xml (app > res > layout > activity_main.xml) öğesini çift tıklayarak açın. Uygulamanın ortasında yalnızca "Hello World" TextView metninin bulunduğu
   Layout Editor'ü (Düzen Düzenleyici) görmelisiniz.

Ardından uygulamanıza bir Button ekleyeceksiniz. Button, Android'de kullanıcının bir işlemi gerçekleştirmek için dokunabileceği bir kullanıcı arayüzü (UI) öğesidir.

Bu görevde, "Hello World" TextView ifadesinin altına Button ekleyeceksiniz. TextView ve Button, ViewGroup türünde olan bir ConstraintLayout içinde yer alır.

ViewGroup içinde Views varsa Views, üst ViewGroup'ün alt öğeleri olarak kabul edilir. Uygulamanızda TextView ve Button, ConstraintLayout üst öğesinin alt öğeleri olarak kabul edilir.

Uygulamanızdaki mevcut ConstraintLayout öğesinin alt öğesi olarak Button eklemeye devam edin.

Not: Aile ağacında olduğu gibi, görünüm hiyerarşisinde üst görünümlerin kendileri alt görünümler olabilir ve alt görünümler de diğer alt görünümlerin üst görünümleri olabilir.

Düzene düğme ekleme

1. Palet'ten bir Button öğesini Tasarım görünümüne sürükleyip "Hello World" TextView öğesinin altına yerleştirin.
   
2. Bileşen Ağacı'ndaki Palet'in altında, Button ve TextView öğelerinin ConstraintLayout altında (ConstraintLayout'in alt öğeleri olarak) listelendiğini doğrulayın.
3. Button öğesinin kısıtlanmadığına dair bir hata bildirimi görürsünüz. Button, ConstraintLayout içinde yer aldığından konumlandırmak için dikey ve yatay kısıtlamalar ayarlamanız gerekir.

Düğmeyi yerleştirme

Bu adımda, Button üst kısmından TextView alt kısmına dikey bir kısıtlama ekleyeceksiniz. Bu işlem, Button simgesini TextView simgesinin altına yerleştirir.

1. Tasarım görünümünde, Button simgesinin üst kenarında mavi kenarlıklı beyaz daireyi basılı tutun. İşaretçiyi sürüklediğinizde işaretçiyi bir ok takip eder. "Hello World" TextView ifadesinin alt kenarına ulaştığınızda bırakın. Bu işlem, bir düzen kısıtlaması oluşturur ve Button, TextView öğesinin hemen altına kayar.
   
2. Düzen Düzenleyici'nin sağ tarafındaki Özellikler'e bakın.
3. Constraint Widget'ta (Kısıtlama Widget'ı) TextView'nin en altına ayarlanmış yeni bir düzen kısıtlaması olduğunu fark edeceksiniz: Top → BottomOf textView (0dp). (0dp), 0 kenar boşluğu olduğu anlamına gelir. Ayrıca, eksik yatay kısıtlamalarla ilgili bir hatanız var.
   
4. Button öğesinin sol tarafından üst öğenin ConstraintLayout sol tarafına yatay bir kısıtlama ekleyin.
5. Aynı işlemi sağ tarafta tekrarlayarak Button simgesinin sağ kenarını ConstraintLayout simgesinin sağ kenarına bağlayın. Sonuç şu şekilde görünmelidir:

6. Button seçiliyken Constraint Widget şu şekilde görünmelidir. Eklenen iki ek kısıtlamaya dikkat edin: Başlangıç → Üst öğenin başlangıcı (0dp) ve Bitiş → Üst öğenin bitişi (0dp). Bu, Button öğesinin üst öğesi olan ConstraintLayout içinde yatay olarak ortalandığı anlamına gelir.
   

7. Uygulamayı çalıştırın. Aşağıdaki ekran görüntüsüne benzer şekilde görünmelidir. Button simgesini tıklayabilirsiniz ancak henüz herhangi bir işlem yapılmaz. Devam edelim.

Düğme metnini değiştirme

Layout Editor'da birkaç kullanıcı arayüzü değişikliği daha yapacaksınız.

Button etiketinin "Düğme" olarak gösterilmesi yerine, düğmenin ne yapacağını belirten bir ifadeyle değiştirin: "Zar at".

1. Düzen Düzenleyici'de Button seçiliyken Özellikler'e gidin, metni Kaydırma olarak değiştirin ve Enter (Mac'te Return) tuşuna basın.

2. Bileşen Ağacı'nda Button'nin yanında turuncu bir uyarı üçgeni görünür. İşaretçiyi üçgenin üzerine getirdiğinizde bir mesaj gösterilir. Android Studio, uygulama kodunuzda sabit kodlanmış bir dize ("Roll") algıladı ve bunun yerine dize kaynağı kullanmanızı öneriyor.

Dizenin sabit kodlanması, uygulamanın diğer dillere çevrilmesini zorlaştırır ve dizelerin uygulamanızın farklı bölümlerinde yeniden kullanılmasını zorlaştırır. Neyse ki Android Studio, bu sorun için otomatik bir düzeltme sunar.

3. Bileşen Ağacı 'nda turuncu üçgeni tıklayın.

Uyarı mesajının tamamı açılır.

4. İletinin alt kısmındaki Önerilen Düzeltme bölümünde Düzelt düğmesini tıklayın. (Sayfayı aşağı kaydırmanız gerekebilir.)
5. Kaynak Ayıklama iletişim kutusu açılır. Bir dizeyi ayıklamak, "Roll" metnini alıp strings.xml içinde roll adlı bir dize kaynağı oluşturmak anlamına gelir (app > res > values > strings.xml). Varsayılan değerler doğrudur. Bu nedenle Tamam'ı tıklayın.

6. Özellikler bölümünde, Button için metin özelliğinin, yeni oluşturduğunuz kaynağı ifade eden @string/roll olarak değiştiğini göreceksiniz.
   

Tasarım görünümünde, Button simgesinde Kaydır yazmaya devam etmelidir.

TextView'u biçimlendirme

"Hello World!" metni oldukça küçük ve mesaj uygulamanızla alakalı değil. Bu adımda, küçük "Hello, World!" mesajını, yuvarlanmış değeri gösterecek bir sayıyla değiştirecek ve yazı tipini daha büyük hale getireceksiniz. Böylece, mesajı görmek daha kolay olacak.

1. Tasarım Düzenleyici'de TextView simgesini seçin. Böylece özellikleri Özellikler penceresinde görünür.
2. TextView öğesinin textSize özelliğini 36sp olarak değiştirin. Böylece metin büyük ve kolay okunabilir olur. textSize'ı bulmak için ekranı kaydırmanız gerekebilir.

3. TextView öğesinin text özelliğini temizleyin. Kullanıcı zar atana kadar TextView bölümünde herhangi bir şey göstermeniz gerekmez.

Ancak uygulamanızın düzenini ve kodunu düzenlerken TextView içinde bazı metinleri görmek çok faydalıdır. Bu amaçla, TextView içine yalnızca düzen önizlemesi için görünür olan ancak uygulama çalışırken görünmeyen metinler ekleyebilirsiniz.

.

4. Bileşen Ağacı'nda TextView simgesini seçin.
5. Ortak Özellikler bölümünde metin özelliğini ve bunun altında araç simgesiyle birlikte başka bir metin özelliğini bulun. Uygulama çalışırken kullanıcıya gösterilecek olan metin özelliğidir. Araç simgesi içeren metin özelliği, yalnızca geliştirici olarak sizin için olan "araç metni" özelliğidir.
6. TextView bölümünde araç metnini "1" olarak ayarlayın (1 zar attığınızı varsaymak için). "1" yalnızca Android Studio'daki Tasarım Düzenleyici'de görünür ancak uygulamayı gerçek bir cihazda veya emülatörde çalıştırdığınızda görünmez.

Bu metin yalnızca uygulama geliştiriciler tarafından görüntülendiği için bunun için dize kaynağı oluşturmanız gerekmez.

7. Önizlemede uygulamanıza bakın. "1" gösteriliyor.

8. Uygulamanızı çalıştırın. Uygulama, emülatörde çalıştırıldığında aşağıdaki gibi görünür. "1" gösterilmiyor. Bu, doğru davranıştır.

Harika, düzen değişikliklerini tamamladınız.

Düğmesi olan bir uygulamanız var ancak düğmeye dokunduğunuzda hiçbir şey olmuyor. Bunu değiştirmek için zarları atan ve düğmeye dokunulduğunda ekranı güncelleyen bir Kotlin kodu yazmanız gerekir.

Bu değişikliği yapabilmek için Android uygulamalarının yapısı hakkında biraz daha bilgi sahibi olmanız gerekir.

Bir Activity, uygulamanızın kullanıcı arayüzünü çizdiği pencereyi sağlar. Genellikle bir Activity, çalışan uygulamanızın tüm ekranını kaplar. Her uygulamanın bir veya daha fazla etkinliği vardır. Üst düzey veya ilk etkinlik genellikle MainActivity olarak adlandırılır ve proje şablonu tarafından sağlanır. Örneğin, kullanıcı cihazındaki uygulamalar listesinde gezinip "Zar Atma" uygulama simgesine dokunduğunda Android Sistemi, uygulamanın MainActivity başlatır.

MainActivity kodunuzda, Activity'nin düzeni ve kullanıcının bu öğeyle nasıl etkileşimde bulunması gerektiği hakkında ayrıntılı bilgi vermeniz gerekir.

• Doğum Günü Kartı uygulamasında, doğum günü mesajını ve resmini gösteren bir Activity bulunur.
• Zar Atma uygulamasında, yeni oluşturduğunuz TextView ve Button düzenini gösteren bir Activity bulunur.

Daha karmaşık uygulamalarda birden fazla ekran ve birden fazla Activity olabilir. Her Activity belirli bir amaca hizmet eder.

Örneğin, bir fotoğraf galerisi uygulamasında, fotoğraf ızgarasını görüntülemek için bir Activity, tek bir fotoğrafı görüntülemek için ikinci bir Activity ve tek bir fotoğrafı düzenlemek için üçüncü bir Activity olabilir.

MainActivity.kt dosyasını açın.

MainActivity içinde bir düğmeye dokunmaya yanıt verecek kodu ekleyeceksiniz. Bunu doğru şekilde yapabilmek için MainActivity uygulamanızda zaten bulunan kod hakkında daha fazla bilgi edinmeniz gerekir.

1. MainActivity.kt dosyasını (app > java > com.example.diceroller > MainActivity.kt) bulup açın. Aşağıdaki ekranı görmeniz gerekir. import... simgesini görürseniz içe aktarılanları genişletmek için ... simgesini tıklayın.

package com.example.diceroller

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle

class MainActivity : AppCompatActivity() {

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(R.layout.activity_main)
   }
}

Yukarıdaki kodun her kelimesini anlamanız gerekmez ancak ne işe yaradığı hakkında genel bir fikriniz olmalıdır. Android koduyla ne kadar çok çalışırsanız koda o kadar aşina olur ve kodu o kadar iyi anlarsınız.

2. MainActivity sınıfının Kotlin koduna bakın. Bu sınıf, class anahtar kelimesi ve ardından adıyla tanımlanır.

class MainActivity : AppCompatActivity() {
    ...
}

3. MainActivity içinde main() işlevi olmadığını fark edin.
   
   Daha önce, her Kotlin programında bir main() işlevi olması gerektiğini öğrenmiştiniz. Android uygulamaları farklı şekilde çalışır. Android sistemi, main() işlevini çağırmak yerine uygulamanız ilk kez açıldığında MainActivity öğenizin onCreate() yöntemini çağırır.
   
4. Aşağıdaki koda benzeyen onCreate() yöntemini bulun.

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(R.layout.activity_main)
   }

override hakkında daha sonraki bir codelab'de bilgi edineceksiniz (bu nedenle şimdilik endişelenmeyin). onCreate() yönteminin geri kalanı, içe aktarmalardan gelen kodu kullanarak MainActivity öğesini ayarlar ve başlangıç düzenini setContentView() ile belirler.

5. import ile başlayan satırlara dikkat edin.
   

Android, Android uygulamaları yazmayı kolaylaştırmak için çok sayıda sınıfın çerçevesini sağlar ancak hangi sınıfı kastettiğinizi tam olarak bilmesi gerekir. import ifadesini kullanarak kodunuzda çerçevedeki hangi sınıfın kullanılacağını belirtebilirsiniz. Örneğin, Button sınıfı android.widget.Button içinde tanımlanır.

Otomatik içe aktarmayı etkinleştirme

Daha fazla sınıf kullandığınızda import ifadelerini eklemeyi hatırlamak çok fazla iş gerektirebilir. Neyse ki Android Studio, başkaları tarafından sağlanan sınıfları kullanırken doğru içe aktarmaları seçmenize yardımcı olur. Bu adımda, Android Studio'yu mümkün olduğunda içe aktarmaları otomatik olarak ekleyecek ve kullanılmayan içe aktarmaları kodunuzdan otomatik olarak kaldıracak şekilde yapılandıracaksınız.

1. Android Studio'da File > Other Settings > Preferences for New Projects (Dosya > Diğer Ayarlar > Yeni Projeler İçin Tercihler) seçeneğine giderek ayarları açın.
2. Diğer Ayarlar > Otomatik İçe Aktarma'yı genişletin. Java ve Kotlin bölümlerinde Add unambiguous imports on the fly (Belirsiz olmayan içe aktarma işlemlerini anında ekle) ve Optimize imports on the fly (for current project) (İçe aktarma işlemlerini anında optimize et (mevcut proje için)) seçeneklerinin işaretli olduğundan emin olun. Her bölümde iki onay kutusu olduğunu unutmayın.
   
   Net olmayan içe aktarmalar ayarları, Android Studio'ya hangi içe aktarma ifadesinin kullanılacağını belirleyebildiği sürece otomatik olarak içe aktarma ifadesi eklemesini söyler. optimize imports (içeri aktarmaları optimize et) ayarları, Android Studio'ya kodunuz tarafından kullanılmayan tüm içe aktarmaları kaldırmasını söyler.
   
3. Tamam'a basarak değişiklikleri kaydedin ve ayarları kapatın.

MainActivity hakkında biraz daha bilgi edindiğinize göre artık uygulamayı, Button simgesini tıkladığınızda ekranda bir işlem yapılacak şekilde değiştirebilirsiniz.

Düğme tıklandığında mesaj gösterme

Bu adımda, düğme tıklandığında ekranın alt kısmında kısa bir mesaj gösterileceğini belirteceksiniz.

1. onCreate() yöntemine setContentView() çağrısından sonra aşağıdaki kodu ekleyin. findViewById() yöntemi, düzendeki Button öğesini bulur. R.id.button, Button için kaynak kimliğidir. Bu, Button'nın benzersiz tanımlayıcısıdır. Kod, Button nesnesinin kendisini değil, rollButton adlı bir değişkende Button nesnesine bir referans kaydeder.

val rollButton: Button = findViewById(R.id.button)

Not: Android, uygulamanızdaki kaynaklara otomatik olarak kimlik numaraları atar. Örneğin, Rulo düğmesinin bir kaynak kimliği vardır ve düğme metninin dizesinin de bir kaynak kimliği vardır. Kaynak kimlikleri R.<type>.<name> biçimindedir (ör. R.string.roll). View kimliklerinde <type>, id'dir. Örneğin, R.id.button.

Kod, Button nesnesinin kendisini değil, Button nesnesine yapılan referansı rollButton adlı bir değişkene kaydeder.

Önemli: Kotlin, bir nesneyi değişkene atadığında her seferinde nesnenin tamamını kopyalamaz, nesneye bir referans kaydeder. Referansı, sosyal güvenlik numarası veya diğer ulusal kimlik numaraları gibi düşünebilirsiniz: Numara bir kişiyi ifade eder ancak kişinin kendisi değildir. Numarayı kopyaladığınızda kişiyi kopyalamazsınız.

onCreate() yöntemi artık aşağıdaki gibi görünmelidir.

override fun onCreate(savedInstanceState: Bundle?) {
   super.onCreate(savedInstanceState)
   setContentView(R.layout.activity_main)

   val rollButton: Button = findViewById(R.id.button)
}

2. Android Studio'nun import için otomatik olarak bir Button ifadesi eklediğini doğrulayın.
   Artık 3 import ifadesi olduğunu göreceksiniz. Üçüncüsü otomatik olarak eklenmiştir.
   

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.widget.Button

Not: Otomatik içe aktarmayı etkinleştirmek işe yaramadıysa Button kırmızı renkte vurgulanır. Metin imlecini Button kelimesinin içine yerleştirip Alt+Enter (Mac'te Option+Enter) tuşuna basarak doğru içe aktarma işlemini manuel olarak ekleyebilirsiniz.

Ardından, Button simgesine dokunulduğunda kodun yürütülebilmesi için kodu Button ile ilişkilendirmeniz gerekir. Tıklama işleyici, dokunma veya tıklama gerçekleştiğinde ne yapılacağını belirten bir koddur. Bu kodu, kullanıcının tıklamasını (bu örnekte Button) bekleyen bir kod olarak düşünebilirsiniz.

3. rollButton nesnesini kullanın ve setOnClickListener() yöntemini çağırarak nesneye bir tıklama dinleyicisi ayarlayın.

rollButton.setOnClickListener {
}

Yazarken Android Studio birden fazla öneri gösterebilir. Bu durumda setOnClickListener {...} seçeneğini belirleyin.

Küme parantezleri içine, düğmeye dokunulduğunda ne olacağına dair talimatlar girersiniz. Şimdilik uygulamanızda, kullanıcıya gösterilen kısa bir mesaj olan Toast görüntülenir.

4. Toast.makeText() numarasını arayarak "Dice Rolled!" metnini içeren bir Toast oluşturun.

val toast = Toast.makeText(this, "Dice Rolled!", Toast.LENGTH_SHORT)

5. Ardından, Toast yöntemini çağırarak Toast öğesinin kendisini göstermesini söyleyin.show()

toast.show()

Güncellenen MainActivity sınıfınız aşağıdaki gibi görünür. package ve import ifadeleri dosyanın en üstünde yer almaya devam eder:

class MainActivity : AppCompatActivity() {

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(R.layout.activity_main)

       val rollButton: Button = findViewById(R.id.button)
       rollButton.setOnClickListener {
           val toast = Toast.makeText(this, "Dice Rolled!", Toast.LENGTH_SHORT)
           toast.show()
       }
   }
}

Tıklama işleyicisindeki iki satırı değişken içermeyen tek bir satırda birleştirebilirsiniz. Bu, diğer kodlarda da görebileceğiniz yaygın bir kalıptır.

Toast.makeText(this, "Dice Rolled!", Toast.LENGTH_SHORT).show()

6. Uygulamayı çalıştırın ve Roll (Rulo) düğmesini tıklayın. Ekranın alt kısmında kısa süre sonra kaybolacak bir pop-up mesaj gösterilir.

Yaşasın! Düğme tıklanınca mesaj açıldı. Android için ilk kez Kotlin kodu yazdınız.

Düğme tıklandığında TextView'ı güncelleme

Geçici bir Toast mesajı göstermek yerine, Rulo düğmesi tıklandığında ekrandaki TextView öğesini güncelleyecek kodu yazacaksınız.

1. activity_main.xml'ya (app > res > layout >activity_main.xml) geri dönün.
2. TextView simgesini tıklayın.
3. id'nin textView olduğunu unutmayın.
   
4. MainActivity.kt dosyasını açın (app > java > com.example.diceroller > MainActivity.kt)
5. Toast simgesini oluşturan ve gösteren kod satırlarını silin.

rollButton.setOnClickListener {
  
}

6. Bunların yerine, TextView değerini depolamak için resultTextView adlı yeni bir değişken oluşturun.
7. findViewById() kullanarak düzen içinde kimliğiyle textView öğesini bulun ve buna referans depolayın.

val resultTextView: TextView = findViewById(R.id.textView)

8. resultTextView üzerindeki metni tırnak içinde "6" olarak ayarlayın.
   

resultTextView.text = "6"

Bu, Özellikler'de metni ayarlayarak yaptığınıza benzer. Ancak şimdi kodunuzda olduğundan metnin çift tırnak içinde olması gerekir. Bu değeri açıkça ayarlamak, şimdilik TextView değerinin her zaman 6 olacağı anlamına gelir. Bir sonraki görevde, zar atmak ve farklı değerler göstermek için kodu ekleyeceksiniz.

MainActivity sınıfı şu şekilde görünmelidir:

class MainActivity : AppCompatActivity() {

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(R.layout.activity_main)

       val rollButton: Button = findViewById(R.id.button)
       rollButton.setOnClickListener {
           val resultTextView: TextView = findViewById(R.id.textView)
           resultTextView.text = "6"
       }
   }
}

9. Uygulamayı çalıştırın. Düğmeyi tıklayın. TextView değerini "6" olarak güncellemelidir.

Eksik olan tek şey zar atmak. Bir zar atma mantığını işleyen önceki kod laboratuvarındaki Dice sınıfını yeniden kullanabilirsiniz.

Dice sınıfını ekleme

1. MainActivity sınıfındaki son küme parantezinden sonra, roll() yöntemiyle Dice sınıfını oluşturun.

class Dice(val numSides: Int) {

   fun roll(): Int {
       return (1..numSides).random()
   }
}

2. Android Studio'nun numSides karakterinin altını dalgalı gri bir çizgiyle çizdiğini fark edin. (Bu işlem biraz zaman alabilir.)
3. İşaretçinizi numSides simgesinin üzerine getirdiğinizde Property 'numSides' could be private (numSides özelliği özel olabilir) yazan bir pop-up gösterilir.
   

numSides adlı öğeyi private olarak işaretlediğinizde bu öğeye yalnızca Dice sınıfında erişilebilir. numSides öğesini kullanacak tek kod Dice sınıfının içinde olduğundan, Dice sınıfı için bu bağımsız değişkeni private olarak ayarlayabilirsiniz. Sonraki ünitede private ve public değişkenleri hakkında daha fazla bilgi edineceksiniz.

4. Make 'numSides' 'private' seçeneğini tıklayarak Android Studio'da önerilen düzeltmeyi yapın.

rollDice() yöntemi oluşturma

Uygulamanıza Dice sınıfını eklediğinize göre, bu sınıfı kullanmak için MainActivity sınıfını güncelleyeceksiniz. Kodunuzu daha iyi düzenlemek için zar atma ile ilgili tüm mantığı tek bir işlevde toplayın.

1. Metni "6" olarak ayarlayan tıklama işleyicisindeki kodu rollDice() çağrısıyla değiştirin.

rollButton.setOnClickListener {
   rollDice()
}

2. rollDice() henüz tanımlanmadığı için Android Studio bir hata bildirir ve rollDice() öğesini kırmızı renkte gösterir.
3. İşaretçinizi rollDice() simgesinin üzerine getirdiğinizde Android Studio, sorunu ve olası çözümleri gösterir.

4. Diğer işlemler... seçeneğini tıklayın. Bir menü açılır. Android Studio, sizin için daha fazla iş yapmayı teklif ediyor.

İpucu: Fare işaretçisini Diğer işlemler... seçeneğinin üzerine getirip tıklamakta zorlanıyorsanız menüyü açmak için rollDice() simgesini tıklayıp Alt+Enter tuşuna (Mac'te Option+Enter) basabilirsiniz.

5. Create function 'rollDice' (İşlev oluşturma "rollDice") seçeneğini belirleyin. Android Studio, MainActivity içinde işlev için boş bir tanım oluşturur.

private fun rollDice() {
    TODO("Not yet implemented")
}

Yeni bir Dice nesne örneği oluşturma

Bu adımda, rollDice() yönteminin zar oluşturup atmasını ve sonucu TextView içinde göstermesini sağlayacaksınız.

1. rollDice() içinde TODO() görüşmesini silin.
2. 6 yüzlü bir zar oluşturmak için kod ekleyin.

val dice = Dice(6)

3. roll() yöntemini çağırarak zar atın ve sonucu diceRoll adlı bir değişkene kaydedin.

val diceRoll = dice.roll()

4. TextView simgesini bulmak için findViewById() numaralı telefonu arayın.

val resultTextView: TextView = findViewById(R.id.textView)

diceRoll değişkeni bir sayıdır ancak TextView metin kullanır. toString() yöntemini diceRoll üzerinde kullanarak bunu dizeye dönüştürebilirsiniz.

5. diceRoll öğesini dizeye dönüştürün ve resultTextView öğesinin metnini güncellemek için bu dizeyi kullanın.

resultTextView.text = diceRoll.toString()

rollDice() yöntemi şu şekilde görünür:

private fun rollDice() {
    val dice = Dice(6)
    val diceRoll = dice.roll()
    val resultTextView: TextView = findViewById(R.id.textView)
    resultTextView.text = diceRoll.toString()
}

6. Uygulamanızı çalıştırın. Zar sonucu 6 dışında başka değerlere değişmelidir. 1 ile 6 arasında rastgele bir sayı olduğundan bazen 6 değeri de görünebilir.

Harikasınız!

Uygulamanızın çalışması için bazı kısımlarda ince ayarlar yaptıktan sonra kodunuzun biraz karışık görünmesi normaldir. Ancak kodunuzdan ayrılmadan önce bazı kolay temizleme görevlerini yapmanız gerekir. Böylece uygulama iyi durumda olur ve ileride bakımı daha kolay yapılır.

Bu alışkanlıklar, profesyonel Android geliştiricilerin kodlarını yazarken uyguladığı alışkanlıklardır.

Android Stil Kılavuzu

Ekiplerle çalışırken ekip üyelerinin kodu benzer şekilde yazması, kodun tutarlı olması açısından idealdir. Bu nedenle Android'de Android kodu yazmayla ilgili bir Stil Kılavuzu vardır. Bu kılavuzda adlandırma kuralları, biçimlendirme ve diğer iyi uygulamalar yer alır. Android kodu yazarken şu yönergelere uyun: Android Geliştiriciler İçin Kotlin Stil Kılavuzu.

Stil kılavuzuna uymanın birkaç yolunu aşağıda bulabilirsiniz.

Kodunuzu temizleme

Kodunuzu yoğunlaştırma

Kodu daha az satırda yazarak kodunuzu daha kısa hale getirebilirsiniz. Örneğin, tıklama işleyicisini Button üzerinde ayarlayan kodu burada bulabilirsiniz.

rollButton.setOnClickListener {
    rollDice()
}

Tıklama dinleyicisiyle ilgili talimatlar yalnızca 1 satır uzunluğunda olduğundan rollDice() yöntem çağrısını ve küme parantezlerini tek bir satırda birleştirebilirsiniz. Bu şekilde görünür. Üç satır yerine tek satır!

rollButton.setOnClickListener { rollDice() }

Kodunuzu yeniden biçimlendirme

Şimdi kodunuzu, Android için önerilen kod biçimlendirme kurallarına uyacak şekilde yeniden biçimlendireceksiniz.

1. MainActivity.kt sınıfında, Windows'da Control+A (veya Mac'te Command+A) klavye kısayolunu kullanarak dosyadaki tüm metni seçin. Alternatif olarak, Android Studio'da Edit > Select All (Düzenle > Tümünü Seç) menüsüne gidebilirsiniz.
2. Dosyadaki tüm metin seçiliyken Android Studio menüsünde Code > Reformat Code (Kod > Kodu Yeniden Biçimlendir) seçeneğine gidin veya Ctrl+Alt+L (Mac'te Command+Option+L) klavye kısayolunu kullanın.

Boşluk ve girinti gibi kodunuzun biçimlendirmesini günceller. Herhangi bir değişiklik görmeyebilirsiniz. Bu durumda sorun yoktur. Kodunuz zaten doğru biçimlendirilmiş demektir.

Kodunuza yorum ekleme

Yazdığınız kodda neler olduğunu açıklamak için kodunuza bazı yorumlar ekleyin. Kod daha karmaşık hale geldikçe, kodu neden bu şekilde yazdığınızı da belirtmeniz önemlidir. Daha sonra değişiklik yapmak için koda geri dönerseniz kodun ne yaptığı hâlâ net olabilir ancak kodu neden bu şekilde yazdığınızı hatırlamayabilirsiniz.

Her sınıf (MainActivity ve Dice, uygulamanızdaki tek sınıflardır) ve yazdığınız her yöntem için yorum eklemek yaygın bir uygulamadır. Bunun kod olmadığını sisteme bildirmek için yorumunuzun başında ve sonunda /** ve **/ sembollerini kullanın. Bu satırlar, sistem kodunuzu çalıştırırken yoksayılır.

Bir sınıfla ilgili yorum örneği:

/**
* This activity allows the user to roll a dice and view the result
* on the screen.
*/
class MainActivity : AppCompatActivity() {

Bir yöntemle ilgili yorum örneği:

/**
* Roll the dice and update the screen with the result.
*/
private fun rollDice() {

Bir yöntem içinde, kodunuzu okuyacak kişiye yardımcı olacağını düşünüyorsanız yorum ekleyebilirsiniz. Yorumunuzun başında // sembolünü kullanabileceğinizi unutmayın. Bir satırda // simgesinden sonra gelen her şey yorum olarak kabul edilir.

Bir yöntem içinde 2 yorum örneği:

private fun rollDice() {
   // Create new Dice object with 6 sides and roll it
   val dice = Dice(6)
   val diceRoll = dice.roll()

   // Update the screen with the dice roll
   val resultTextView: TextView = findViewById(R.id.textView)
   resultTextView.text = diceRoll.toString()
}

1. Kodunuza yorum eklemek için biraz zaman ayırın.
2. Yorum ve biçimlendirme ile ilgili tüm bu değişikliklerden sonra, uygulamanızın beklendiği gibi çalışmaya devam ettiğinden emin olmak için uygulamayı tekrar çalıştırmanız iyi bir uygulamadır.

Kodunuza yorum eklemenin bir yolu için çözüm koduna bakın.

Bu codelab'in çözüm kodu, aşağıda gösterilen proje ve modülde yer alır.

Çözüm Kodu URL'si: https://github.com/google-developer-training/android-basics-kotlin-create-dice-roller-with-button-app-solution

Bu codelab'in kodunu GitHub'dan almak ve Android Studio'da açmak için aşağıdakileri yapın.

1. Android Studio'yu başlatın.
2. Welcome to Android Studio (Android Studio'ya Hoş Geldiniz) penceresinde Check out project from version control'u (Projeyi sürüm kontrolünden kullanıma alma) tıklayın.
3. Git'i seçin.

4. Clone Repository (Depoyu Klonla) iletişim kutusunda, sağlanan kod URL'sini URL kutusuna yapıştırın.
5. Test düğmesini tıklayın, bekleyin ve Bağlantı başarılı yazan yeşil bir pop-up balon olduğundan emin olun.
6. İsteğe bağlı olarak, Dizin'i önerilen varsayılandan farklı bir şeyle değiştirin.

7. Klonla'yı tıklayın. Android Studio, kodunuzu getirmeye başlar.
8. Checkout from Version Control (Sürüm Kontrolünden Ödeme) pop-up'ında Yes'i (Evet) tıklayın.

9. Android Studio'nun açılmasını bekleyin.
10. Codelab başlangıç veya çözüm kodunuz için doğru modülü seçin.

11. Kodunuzu oluşturup çalıştırmak için Çalıştır düğmesini tıklayın.

Yardım: İndirdiğiniz kod düzgün yüklenmiyor veya çalışmıyorsa Yardım ve Sorun Giderme Kılavuzu'na bakın.

• Düzen Düzenleyici'yi kullanarak Android uygulamasına Button ekleyin.
• Uygulamaya etkileşimli davranış eklemek için MainActivity.kt sınıfını değiştirin.
• Doğru yolda olduğunuzu doğrulamak için geçici bir çözüm olarak Toast mesajı gösterin.
• Button tıklandığında davranış eklemek için setOnClickListener() kullanarak Button için bir tıklama işleyici ayarlayın.
• Uygulama çalışırken düzen içindeki TextView, Button veya diğer kullanıcı arayüzü öğelerinde yöntemleri çağırarak ekranı güncelleyebilirsiniz.
• Kodunuzu okuyan diğer kişilerin yaklaşımınızı anlamasına yardımcı olmak için kodunuza yorum ekleyin.
• Kodunuzu yeniden biçimlendirin ve temizleyin.

• Button sınıfı
• Toast sınıfı
• TextView sınıfı
• Android Geliştiriciler için Kotlin Stil Kılavuzu

Not: Pratikler isteğe bağlıdır. Bu alıştırmalar, bu codelab'de öğrendiklerinizi uygulamanıza olanak tanır.

Aşağıdakileri yapın:

1. Uygulamaya başka bir zar ekleyin. Roll (Zar at) düğmesini tıkladığınızda 2 zar atılmalıdır. Sonuçlar ekranda 2 farklı TextViews olarak gösterilmelidir.

Çalışmanızı kontrol etme:

Tamamlanan uygulamanız hatasız çalışmalı ve uygulamada iki zar göstermelidir.