MehmetX.com

Xamarin - Android APK Oluşturma

21.10.2017 00:54:12 | Okunma Sayisi : 14651 | Yorum Sayisi : 0


Bu makalede çok fazla detaya girmeden, Xamarin ile hazırladığınız Android uygulamasının APK' sının nasıl oluşturulacağını anlatıp, sonraki makalede biraz daha detaya girerek; ikon değiştirme, APK boyutunu düşürme, obfuscating (kod karıştırma) gibi konulara değineceğim.

Uygulamanızı yazdınız, test ettiniz ve kullanıma hazır olduğunu düşünüyorsunuz. Yapmanız gereken bir sonraki işlem; Android uygulamanızın APK' sını oluşturmaktır.

Oluşturduğunuz APK dosyasını; Google Play gibi bir MarketPlace' te dağıtabilir (distribute) ya da doğrudan Android işletim sistemleri cihazlara kurabilirsiniz.

APK oluşturmak için adımları şu şekilde sıralayabiliriz.

  1. Proje derlenir
  2. Projeye sağ tıklayıp Properties seçilir
  3. Properties penceresinde Android Manifest sekmesine tıklanır
  4. Açılan pencerede Package name, Version number ve Version name bilgileri girilir
  5. Android Options sekmesinde Configuration alanından Release seçilir
  6. Projeye sağ tıklayıp Archive seçilir
  7. Archive işlemi tamamlandıktan sonra Distribute butonu tıklanır
  8. Distribute Channel penceresi ekrana gelir, bu pencerede Ad Hoc seçilir
  9. Signing Identity penceresi ekrana gelir, bu pencerede yeşil artı butonu tıklanır
  10. Create Keystore penceresi ekrana gelir, bu pencerede ilgili alanlar doldurulur ve Create butonuna basılır
  11. Signing Identity penceresinde listeden ilgili Keystore seçilir ve Save As butonu tıklanır
  12. APK' nın oluşturulacağı yer seçilir
  13. Parola istenen pencereye Create Keystore penceresinde kaydedilmiş olan parola girilir
  14. APK hazırdır.
 


Bu işlemleri bir de resimli olarak inceleyelim.

APK oluşturmak için Android projesine sağ tıklayıp Properties seçelim.
visual_studio_xamarin_android_properties.png


Properties seçtikten sonra gelen pencerede sol menüden Android Manifest seçtikten sonra sağ taraftaki Package name alanına bir isim girelim, Version number alanına 1Version name alanına da 1.0 girelim.
visual_studio_xamarin_android_properties_android_manifest_package_name


Sol taraftan Android Options seçtikten sonra gelen pencerede en üstte Configuration seçeneklerinden Release' i seçelim.
visual_studio_xamarin_android_options_configuration.png


Solution Explorer üzerinden Android projesine tekrar sağ tıklayıp Archive seçelim.
visual_studio_xamarin_android_archive


Archive seçtikten sonra Archive Manager penceresi açılacaktır ve archive işlemi başlayacaktır. Bu işlemin tamamlanmasını bekleyelim. İşlem tamamlandıktan sonra bir hata almadıysanız aşağıdaki gibi bir görüntü ile karşılaşacaksınız. Sağ alt köşedeki Distribute butonuna tıklayalım.
visual_studio_xamarin_android_archive_manager


Distribution Channel penceresi gelecektir. Bu pencerede Ad Hoc seçelim.
visual_studio_xamarin_android_distribution_channel.png


Ad Hoc seçtikten sonra karşınıza Signing Identity ekranı gelecektir. Android, APK' ların bir sertifika ile dijital olarak imzalanmış olmasını gerektirir. Bu yüzden bir Keystore oluşturmamız gerekmektedir. Bu ekranda altta bulunan yeşil artı butonuna tıklayalım.

Create Android Keystore penceresi açılacaktır. Bu pencerede Alias alanına bir isim girelim, Password ve Confirm alanlarına parola girelim, bir de alt paneldeki alanlardan bir tanesine giriş yapalım ve Create butonuna tıklayalım.
visual_studio_xamarin_android_signing_keystore


Create' e tıkladıktan sonra Signing Identity penceresindeki listeden Keystore' u seçip Save As butonuna tıklayalım. Oluşacak APK dosyasının bilgisayarınız üzerinde kaydedileceği yeri seçtikten sonra distribution işlemi başlayacaktır. İşlem başladığı zaman parola isteyen bir ekran gelecektir karşınıza, Create Android Keystore penceresinde tanımlamış olduğunuz parolayı girmeniz gerekir bu pencerede.
visual_studio_xamarin_android_signing_identity


Distribution işlemi tamamlandıktan sonra kaydettiğiniz yere giderek ya da sağ altta bulunan Open Distribute butonuna tıklayarak APK dosyanıza ulaşabilirsiniz.
visual_studio_xamarin_android_distribution_completed


Artık bu APK dosyasını bilgisayarınıza bağladığınız bir Android cihaza kurabilir, ya da internet üzerinde bir yere koyarak Android cihazlara download ederek kurabilirsiniz.
visual_studio_xamarin_android_apk_file


APK oluşturmaya çalışırken alabileceğiniz hatalardan bazıları şunlardır:

Signing packages failed. jarsigner error: java.lang.RuntimeException: keystore load: Keystore was tempered with, or password was incorrect
  • Bu hatanın sebebi; Distribution anında sizden parola istenen pencerede yanlış parolayı girmiş olmanızdır.
  • Çözüm için; Create Android Keystore penceresinde tanımlamış olduğunuz parolayı girmeniz gerekir.
 


Shared Mono runtime is enabled for 'Assembly adı'. The selected build configuration is using the shared Mono runtime for faster deploypment. Apps cannot be archived with this setting enabled. Please ensure that you are using a release configuration and that the "Use Shared Mono Runtime" opetion in your project' s build option is unchecked.
  • Bu hatanın sebebi; Uygulamanın varsayılan olarak Debug konfigürasyonunda iken (Use Shared Runtime seçeneğinin işaretli iken) Archive yapılmasıdır.
  • Çözüm için; Proye' ye sağ tıklayıp Properties seçtikten sonra Android Options' ta Configuration alanından Release seçmeniz gerekir (Bunu seçtiğiniz taktirde Use Shared Runtime seçeneğinin de seçiliğini kalkacaktır).

0 Yorum




page-top