Önceki yazımda hibrit mobil uygulamaların önemi ve geliştirici olarak bize kattığı yararlardan bahsetmiştim. Şimdi ise Apache Cordova ile nasıl proje oluşturulur onun üzerine değineceğim.

Gerekli Bağımlılıkların Yüklenmesi

Cordova bir npm paketi olduğu için sistemimizde NodeJS kurulu olmak zorunda. Eğer yüklü değilse NodeJS sitesinden ilgili kurulum dosyasını indirip yükleyelim. Şu an bu yazıyı yazarken v6.10.3 LTS (Recommended) sürümü mevcut. Size de önerim LTS sürümünü yüklemeniz. Gerekli kurulumu işlemini gerçekleştirdikten sonra sisteminizde yüklü olup olmadığını test etmek için node -v komutunu kullanabilirsiniz. Çıktısı v6.10.3 olacaktır.

Cordova’nın Kurulumu

Komut penceresini (cmd.exe’yi) açıp aşağıdaki komutu girerek Cordova’nın ilgili bağımlılıklarının npm’den yüklenmesini ve kurulumun tamamlanmasını sağlayalım.

npm install -g cordova

Not: Buradaki -g parametresi, Cordova’nın global olarak yüklenmesini ve herhangi bir dizinden çalıştırılabilmesini sağlar.

Uygulamanın Oluşturulması

Cordova projelerimizi toplu bir yerde tutmak için bir dizin oluşturalım. C: dizinine gidip CordovaProjelerim adında bir dizin oluşturup içerisinde aşağıdaki komutunu çalıştırarak merhabaDunya adında bir Cordova projesi oluşturalım.

cordova create merhaba com.ornek.merhaba merhabaDunya

cd merhaba komutu ile proje dizininin içerisine girelim ve dir komutu baktığımızda ilgili proje dosyalarının oluştuğumu göreceğiz.

Platformların Eklenmesi

Projemizin hangi platformda/işletim sisteminde çalışacağını belirtmek için ilgili platform adını aşağıdaki şekilde ekliyoruz.

• Android için:

cordova platform add android

• iOS için:

cordova platform add ios

Hangi platformları eklediğimizi kontrol etmek için ise aşağıdaki komutu kullanabiliriz:

cordova platform ls

Not: Platform ekleme komutlarını çalıştırdığımızda proje içerisindeki platforms dizini altında oluşan proje dosyalarını görebiliriz:

Derleme için Ön Gereksinimler

Belirli bir platforma göre derleme işlemini yürütebilmek için ilgili platformun SDK’leri sistemimizde kurulu olmalıdır. Platformlara derleme hakkında eksik gereksinimlerimizin olup olmadığını kontrol etmek için aşağıdaki komutu çalıştıralım:

cordova requirements

Not: Buradaki gibi Apple OS X: not installed gibi bir hata alırsanız endişelenmeyin. Cordova burada bize Windows ortamında iOS derlemesinin yapılamayacağını söylüyor. platforms/ios dizinini alıp arkadaşınızın macOS makinesinde derlerseniz iOS uygulamanız da oluşturulmuş olacaktır.

Uygulamanın Derlenmesi

cordova create komutu varsayılan olarak, başlangıç sayfası wwww\index.html olan bir web projesi oluşturur. Cordova ile ilgili herhangi bir JS değişkeninin oluşturulması işlemleri www/js/index.js dosyası içerisindeki deviceready fonksiyonu içerisinde yapılmalıdır.

Tüm platformlara derleme yapabilmek için aşağıdaki komutu kullanabiliriz:

cordova build

Veya sadece Android’e derleme yapıyorsak platformun adını belirtmemiz yeterli:

cordova build android

Not: Komutu ilk kez çalıştırıyorsanız Android projesinin derlenme süresi ilgili kütüphanelerin indirilmesi vb. süreçlerden dolayı yaklaşık 5 dk alabilir. Fakat daha sonraki derlemelerde bu süre çok daha azalacaktır.

Uygulamanın Test Edilmesi

Mobil platformlar için oluşturulan SDK’ler, genellikle ilgili uygulamayı açabilmek için bir emülatör ile birlikte gelir. Aşağıdaki gibi bir komut çalıştırarak uygulamayı tekrar derleyip ilgili platformun emülatöründe test edebiliriz.

cordova emulate android

Cordova ile temel bir Android projesi oluşturduk. Sonraki yazımda Cordova ve Framework7 ile mobil projelerin oluşturulması üzerine değineceğim.