UNITY Android SDK Kurulumu – Resimli Anlatım

Hepinize tekrar merhaba,

Bu derste UNITY 3D oyun motorunda Android‘e oyun geliştirmek için gerekli olan Android SDK‘nın kurulumunu anlatacağım.

NOT: Unity 2019 ile birlikte, artık Android modülünü kurarken otomatik olarak Android SDK’da kurabiliyorsunuz. Bu yolu kendim denemediğim için Admob gibi plugin’ler ile ne kadar uyumludur bilmiyorum ama eğer Android SDK’yı bu şekilde kurmak isterseniz, dersin devamını okumanıza gerek yok:

Hazırsanız başlayalım…

Her şeyden önce Android SDK’nın yüklenebilmesi için sisteminizde Java JDK (Development Kit)’in kurulu olması lazım. Java’nın resmî web sitesinden (http://www.oracle.com/technetwork/java/javase/downloads/index.html) JDK’yı kolayca temin edebilirsiniz.

NOT: Unity’nin JDK 9 sürümü ile olası bir uyumsuzluğundan dolayı (https://forum.unity.com/threads/java-9-jdk-9-support-by-unity-android.499354/) JDK 8 kurmanızı öneririm: http://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-2177648.html

Android SDK’yı iki şekilde kurabilirsiniz: Android Studio kullanarak veya SDK Manager kullanarak. Artık Google’ın tavsiye ettiği yöntem Android Studio ile SDK kurulumu olduğu için, ben de aynısını öneriyorum. Mümkünse SDK Manager kullanmayın.

Android Studio ile SDK Kurulumu

BONUS: Android Studio’nun bir başka avantajı da, beraberinde gelen Logcat ile oyunlarınızı debug edebilmeniz: https://yasirkula.com/2015/10/13/unity-android-oyunlarinizi-debug-etmek/

1- Android Studio’yu kurun: https://developer.android.com/studio

2- Uygulamayı açın ve Tools-Android-SDK Manager ayarlarını açın (veya bir proje oluşturmadan direkt SDK ayarlarına ulaşmak için resimdeki yolu izleyin:

3- Benim önerim, öncelikle Android SDK’yı güzel bir konuma taşımanız (özellikle içerisinde boşluk karakteri olmayan bir konuma çünkü yoksa bazen Android Studio sapıtabiliyor). Bunun için gelen pencerede Android SDK Location yazan yeri kopyalayın, o konuma gidin ve o klasörü C:\android-sdk gibi daha güzel bir konuma taşıyın (direkt klasörü kesin, C’ye veya D’ye yapıştırın ve ismini android-sdk yapın). Ardından bu yeni konumu Android SDK Location’a şekildeki gibi aktarın:

4- Konumu değiştirdikten sonra emin olmak için Android Studio’yu bi yeniden başlatın.

5- Açıkçası artık hangi Android SDK bileşenlerinin Unity (ve kullanıyorsanız Admob gibi plugin’ler) için gerekli/yeterli olduğunu bilmiyorum, o yüzden direkt kendi ayarlarımı aşağıdaki resimde gösterdim. Ben bu bileşenler kurulu iken Unity’de Android’e sıkıntısız build alabiliyorum:

Bu bileşenleri seçtikten sonra sağ alttaki Apply tuşuna basarak onları kurabilirsiniz. Yüklü bir bileşende güncelleme olduğu zaman, o bileşenin sağındaki Status kısmında “Update available” yazar. Bu durumda o bileşeni güncellemek için de yanındaki kutucuğu işaretleyip yine Apply yapabilirsiniz.

EKLEME (30.05.2019): Resimdeki bileşenler yüklü iken Unity 2018.3 ile Gradle‘da build alırken sıkıntı yaşadım, çözmek için sağ alttaki “Show Package Details” butonuna tıklayıp “SDK Build-Tools“da şu şekilde değişiklik yaptım ve Apply dedim. Bu sefer build almaya çalışınca Unity karşıma bir kutucuk çıkardı ve ben bu kutucuktaki Update butonuna tıkladıktan sonra (niye böyle bir kutucukla karşılaştığımı ben de bilmiyorum) başarılı bir şekilde build alabildim.

SDK Manager ile SDK Kurulumu (Önerilmez)

1- 

http://developer.android.com/sdk/index.html adresine girin. Aşağılardaki “Other Download Options-SDK Tools Only” başlığı altında yer alan linki kullanarak installer’ı bilgisayarınıza indirin.

Güncelleme (28.01.2017): Artık “SDK Tools Only” seçeneği kalkmış gibi gözüküyor. Onun yerine şu linkten SDK Manager’ı indirebilirsiniz: https://dl.google.com/android/installer_r24.4.1-windows.exe

Kaynak: http://stackoverflow.com/questions/37505709/how-do-i-download-the-android-sdk-without-downloading-an-android-studio

2- Dosyayı indirin ve çalıştırın. Yükleme penceresinde “Next” butonuna bastıktan sonra 2 durumla karşılaşmanız olası: ya yükleme işlemi istendiği gibi devam eder ya da aşağıdaki resimdeki gibi bir “JDK not found” hatasıyla karşılaşırsınız. Eğer karşınıza bu hata ekranı çıktıysa 3. ve 4. adımları uygulayın, yükleme sorunsuz gerçekleştiyse 5. adıma zıplayın.

3- Bilgisayar’a sağ tıklayıp Özellikler deyip Gelişmiş sistem ayarları-Ortam Değişkenleri… yolunu izleyin. Karşınıza gelen pencerede “Yeni…” butonuna tıklayın.

4- “Değişken adı:” olarak JAVA_HOME yazın ve “Değişken değeri:” olarak JDK‘yı kurduğunuz klasörün konumunu yazın ve ardından “Tamam“a tıklayın. Şimdi Android SDK kurulumunu tekrar çalıştırın.

5- Kurulum işlemi tamamlandıktan sonra “Android SDK Manager” açılacak. Burada seçeceğiniz maddeleri isterseniz benim yaptığım gibi yapabilirsiniz (mümkün olduğu kadar gereksiz seçimleri kaldırmaya çalıştım). Dikkat etmeniz gereken husus “Android 2.2“den büyük en az 1 tane madde seçmiş olmanız ve ayrıca “Google USB Driver“ın ve “Tools“taki 2 seçeneğin de seçili olması. Seçimlerinizi yaptıktan sonra “Install x packages…” butonuna tıklayın.

6- Şimdi karşınıza gelecek olan pencerede sol taraftan “Android Googletv License” ve “Android SDK License” gibi ana başlıkları tek tek seçip sağ alttan “Accept License” seçeneğini seçin. Tüm ana başlıklar için bunu yaptıktan sonra “Install” butonuna tıklayarak Android SDK’nın kurulumunun tamamlanmasını bekleyin.

SDK’nın Unity’e Tanıtılması

1- (Unity 5 ve üzeri için) Unity’i kurarken Android Build Support seçeneğini seçmiş olmanız lazım. Eğer bu seçeneği seçmeyi unuttuysanız Unity setup dosyasını açıp sadece “Android Build Support”u işaretleyip kurulumu tamamlayın.

2- Unity’i açıp “Edit-Preferences…-External Tools…” yolunu izleyin, “Android SDK Location” kısmına tıklayın ve Android SDK’yı kurduğunuz konumu seçin (Bende C:\android-sdk konumunda).

2.1- (Unity 2019 ve üzeri için) Eğer Unity ile gelen Android SDK’yı (dersin başındaki resme bakınız) kurmak yerine bu dersteki yolu izlediyseniz, 2. adımı şu şekilde uygulayabilirsiniz:

• Yine aynı “Edit-Preferences…-External Tools…” penceresinden “Android SDK Tools Installed With Unity” seçeneğinin başındaki tiki kaldırın ve SDK‘ya Android SDK’nın konumunu girin
• Eğer build alırken sıkıntı yaşarsanız, “JDK Installed With Unity“nin başındaki tiki de kaldırıp JDK‘ya kendi kurduğunuz Java JDK’nın konumu girin

Vee artık hazırsınız! Dilerseniz test amaçlı boş bir proje oluşturun ve Android’e Build yapın. Eğer hata almadan “.apk” dosyasını oluşturabiliyorsanız kurulum sorunsuz tamamlanmış demektir. Hayırlı olsun.

NOT: Çoğu kişi Build ederken şuna benzer bir hata alıyor: “Error building Player: Win32Exception: ApplicationName=’D:\Program Files (x86)\Android\android-sdk\tools\zipalign.exe’, CommandLine=’4 “blabla” “blabla”‘, CurrentDirectory=’Temp/StagingArea’“. Bu hatanın çözümü için şu dersteki “NOT2“yi okuyun: