MOBİL OYUN PROGRAMLAMA EĞİTİMİ KURULUM KILAVUZU Bu kılavuzda, Gamelab Istanbul tarafından geliştirilmiş olan Ngdroid Oyun Motoru kullanılarak oyun geliştirmek için yapılması gereken kurulumlar anlatılmaktadır. 1. ÖN HAZIRLIK Kuruluma başlamadan önce birtakım ön hazırlıkların yapılması gerekmektedir. 1-) Android Studio programı https://developer.android.com/studio/ adresinden indirilmelidir. 2-) Git for Windows programı https://git-scm.com/download/win adresinden indirilmelidir. İndirme işlemine başlarken kullanılacak bilgisayarın özelliklerine göre programın 64 bit veya 32 bit sürümü seçilmelidir. 3-) Github.com sitesinde kullanıcı hesabı açmak için https://github.com adresi ziyaret edilerek Sign Up bağlantısına tıklanmalıdır. Üyelik formunun gerekli alanları doldurulup onayladıktan sonra, Github tarafından kullanıcının email adresine aktivasyon emaili gönderilmektedir. Aktivasyon emaili posta kutusuna gelmediyse spam kutusu da kontrol edilmelidir. Gönderilen postadaki aktivasyon linkine tıklanarak hesap aktive edilmeli ve kullanıma hazır hale getirilmelidir. Ön hazırlık işlemlerini tamamladıktan sonra, Android Studio ve Git for Windows programlarının kurulum dosyaları ile Github.com sitesi üyeliği kurulum işlemleri için hazır hale getirilmiş bulunmaktadır. Takip eden bölümde kurulum işlemleri anlatılacaktır. 2. KURULUM 1-) C:\dev\android\workspace klasörlerini oluşturun. 2-) İndirilen Android Studio yükleme dosyasına çift tıklayın ve kurulumu başlatın. 3-)ANDROİD STUDİO NASIL KURULUR? Bölümün de kurulumun ayrıntılı görselleri mevcuttur. 4-)Git for Windows yükleme dosyasına çift tıklayıp açın. Hiçbir ayar değiştirmeden ileri butonuna tıklayın ve programı yükleyin. 1
5-) Şimdi Mobil oyun programlama için kullanılacak projeyi Git hesabınıza klonlayınız. GİT HESABINDAN DOSYA KLONLAMA bölümünde ayrıntılı görsel bulunmaktadır. Oradaki adımları yaptıktan sonra 6.adıma geçin. 6-) Projeyi ilk açtığınız da hata gibi gözüken bir mesaj penceresi görünecektir. Bu mesaj penceresi sadece bilgilendirme amaçlıdır. Kullanacağı Sdk adresinin projeye yazılacağını söylemektedir. Proje açıldığında yapacağı ilk iş gradle indirmeye başlaması olacaktır. Bu konumda iken internetinizin kopmamasına özen gösterin. Eğer internet bağlantınız kesilir ise hata vermeye ve tekrar indirmeye çalıştığınız da indirememeye başlayacaktır. Bunu düzeltmek için ise proje içindeki gradle-wrapper properties adındaki dosyayı açıp distributionurl=https\ sekmesindeki https kelimesini http olarak değiştirin. Tekrar indirmeye başlayacaktır. Bir sonraki gelecek pencere alttadır. Orada güncelle seçeneğini seçin. 2
Bu pencere ile karşılaşır iseniz iptal deyin. Aslında hata değil git güncelleme dosyaları lakin hesabınızdaki projeyi güncellemenize gerek olmayacağından eklemenize gerek yoktur. 7-)Projeyi çalıştırmak için 2 yöntem vardır. Birincisi kendi telefonunuzu(android olması gerek) USB bağlantısı ile bağlayıp kullanabilirsiniz ve ya emülatör yardımı ile sanal telefon oluşturup kullanabilirsiniz. Burada emülatör ile nasıl sanal telefon açılır onu anlatan bölüme gitmek için Android Emülatörü oluşturma bölümünü okuyunuz. 8-) Bütün işlemleri yapıp projeyi Run(Shift + F10) tuşu ile açtığınızda ekranda Gamelab İstanbul logosunun görünüyor olması gerekmektedir. 3
3. PHOTOSHOP KURULUMU 3.1. Google aramasına "download photoshop" yazarak Photoshop programını bilgisayarınıza indirin ve kurun. 3.2. Bir alternatif olarak da GIMP for Windows kelimesini Google da aratıp bu programı da kullanabilirsiniz. Photoshop için bir alternatif olup ücretsiz bir programdır. ANDROID STUDIO NASIL KURULUR? 1.Adım 4
2.Adım 5
3.Adım Android Studio nun kurulacağı dosya yolunu belirtiniz. 6
4.Adım Install a tıklayarak kurulumu başlatın. 5.Adım Yükleme bittikten sonra açtığınızda bir yükleme penceresi daha çıkacak. İleri deyip ilerlemeye devam edin. Do not import settings diyerek devam edin. 7
6. Adım Burada Android Studio Sdk dosyalarını indirmeye başlayacak. Burada da internet başlantısı gerekmektedir. 8
7.Adım İndirme işlemi bittikten sonra ana menüye gelecektir. 9
GIT HESABINDAN DOSYA FORK ETME 1.Adım Git Hesabınıza giriş yapın. 2.Adım Üstteki arama çubuğuna NgdroidApp yazıp aratın. Eğer resimdeki gibi bulamadığınız taktirde link buradadır https://github.com/gamelab-istanbul/ngdroidapp. 10
3.Adım Fork tuşuna basarak kendi hesabınıza projeyi fork(yani clone işlemi) edin. 11
4.Adım Kendi hesabınıza gelip orada NgdroidApp projesini açıp, Clone or download seçeneğinden verilen linki kopyalayın. 12
5.Adım Kopyaladığınız adresi Android Studio ana menüsündeki Check Out Version Control sekmesinden Git ( git hub değil) sekmesine tıklayın. Çıkan menüdeki URL kısmına yapıştırın. Test tuşuna basın ve alttaki Test Connection success yazısını gördükten sonra Parent Directory bölümüne C:\dev\android\workspace yazın ve ya seçin adresi ve sonra Clone tuşuna basın. 6.Adım Git hesabınızdan fork ladığınız dosyayı Android Studio git hesabından çekmiş olacak. Android Studio dosyayı açmak ister misiniz diye soracak, ona evet deyip projeyi açın. Şimdi Kuruluma dönüp kaldığınız yerden devam edin. 13
ANDROİD EMULATÖR OLUŞTURMA 1.Adım Android Studio menüsünden Tools->Android->AVD Manager seçeneğini seçin. 14
2.Adım New Virtual Device butonuna tıklayın. Oradan çalışacağınız proje ve çözünürlüğüne uygun bir tanesini (şuanki standart full HD 1080*1920 çözünürlükte bir telefon) seçip İleri tuşuna basın. 15
3.Adım Sanal telefona yükleyeceğiniz işletim sistemini (API) seçmek ile ilgili iki önemli nokta var. Resimdeki özellikleri taşıyan bir tane seçmemiz gerekiyor. (Google API) ve x86_64 yazılarının bulunduğu bir taneye(resimdeki gibi) seçip Download seçeneğini tıklayın ve indirin. İndirdikten sonra İleri seçeneği aktif olacak seçin ve Finish seçeneğini tıklayarak sanal telefonunuzu oluşturun. 16
4. Adım Android studio da sağ üst köşedeki (App yanındaki) Play(Shift + F10) tuşuna basın. Çıkan menüde açtığınız sanal telefonu seçip OK tuşuna basıp projeyi çalıştırın. 17