Cordova CLI Kullanım Rehberi

29 Ocak 2014
Bu yazıyı beğendiysen paylaşmayı unutma :)
Pin It

Cordova CLI yani “Cordova Komut Satırı Arayüzü”nü kullanarak neler yapabileceğinizi ve nasıl kullanabileceğinizi bu yazıdan öğrenin!

Bu yazıda “Cordova Proje Yapısı nasıldır?“, “Emülatör nasıl eklenir?“, “CLI nasıl kurulur?” gibi “başka” konulara girmeyeceğiz. Ancak CLI’ın nasıl kullanıldığı ve kullanılması gerektiği hakkındaki bilgilere bu yazıda ulaşabilirsiniz. Aşağıda görebileceğiniz 22 başlıkta sorulara verilmiş cevaplar bu yazının içeriğini oluşturur. Haydi başlayalım!

1. Cordova CLI Nedir?
2. Ne zaman kullanılmaya başlandı?
3. Ne sağlar?
4. Kullanmak için neler gerekli?
5. Yeni Cordova uygulaması nasıl oluşturulur?
6. Cordova uygulamasına platform nasıl eklenir?
7. Cordova uygulamasından platform nasıl silinir?
8. Cordova uygulamasında kurulu platformlar nasıl listelenir?
9. Kurulu olan Cordova sürümü nasıl öğrenilir?
10. Cordova sürümünü nasıl güncellersiniz?
11. İstediğiniz Cordova sürümünü nasıl yüklersiniz?
12. Cordova pluginleri nasıl yüklenir?
13. Cordova pluginleri nasıl kaldırılır?
14. Kurulu olan Cordova pluginleri nasıl listelenir?
15. Proje, tüm platformlar için nasıl hazır hale getirilir?
16. Tüm platformlar için nasıl derleme işlemi yapılır?
17. Tüm platformlar için nasıl inşa işlemi yapılır?
18. Uygulamanızı lokal bir sunucuda nasıl çalıştırırsınız?
19. Uygulamanızı cihaz üzerinde nasıl çalıştırırsınız?
20. Uygulamanızı emülatör üzerinde nasıl çalıştırırsınız?
21. Komutları unuttum, nasıl hatırlarım?
22. Yapılan işlemleri daha detaylı görmek istiyorum, ne yapabilirim?

1. Cordova CLI Nedir?

CLI (Cordova Command-line Interface – Cordova Komut Satırı arayüzü), herhangi bir IDE yardımına ihtiyaç duymaksızın yalnızca kod satırını kullanarak proje oluşturulmasını, güncellenemesini, plugin ekleme/çıkarma işlemlerinin yapılmasını, yeni platformaların eklenmesini ve daha pek çok işlevi tek bir merkezden yönetilmesini sağlar. Kısa tanımı ile bir Cordova projesinin komut satırı arayüzünü oluşturur diyebiliriz.

2. Ne zaman kullanılmaya başlandı?

Cordova 2.7’den itibaren kullanılmasına izin verilmiş olsa da asıl olarak Cordova 3.0 ile birlikte kullanılmaya başlamıştır. Bu sebepten dolayı http://phonegap.com/install/ sayfasında Cordova kütüphanesinin indirilebilir halleri en son PhoneGap 2.9.1 sürüme kadar devam ettirilmiştir. Cordova 3.0 ile birlikte bu işlem tamamen CLI aracılığı ile yapılmaya başlanmıştır.

3. Ne sağlar?

Bu durum bir anlamda çalışma konusunda sizi ortam bağımsız hale getirir. Bunun anlamı şudur; örneğin Android ortamı için bir Cordova projesi geliştiriyorken Eclipse editörünü hiç açmadan tüm işlemlerinizi CLI üzerinden yürütüp, favori web geliştirme aracınızı kullanarak geliştirmeye devam edebilirsiniz. Bu da büyük bir özgürlük demek! Özellikle 3.0 versiyondan önce Cordova çalışma ortamını kurmak oldukça zahmetli bir işlemdi. Pek çok dosyayı bir yerlere kopyalamanız ve gerekli düzenlemeleri yapmanız gerekiyordu. Özellikle bu zahmetten kurtulmak için geliştiriciler Eclipse üzerine kurulan PhoneGap plugininden faydalınıyordu. Artık buna ihtiyaç duymaksızın Cordova CLI ile tüm bu işlemleri gerçekleştirmek oldukça kolay.

4. Kullanmak için neler gerekli?

Cordova CLI’yı kullanmak için aşağıdaki iki adımı tamamlamanız yeterli.

1. http://nodejs.org adresinden Node.js’i indirin ve kurun. Bu işlemden sonra “npm” komutu bilgisayarınızın komut satırından kullanılmaya hazır hale gelmiş olacak.

2. Node.js kurulumunu gerçekleştirdikten sonra “npm install -g cordova” komutu kullanılarak Cordova CLI komutları kullanıma hazır hale gelmiş olur.

3. CLI’yı çalıştırmadan önce, kullanacağınız her platformun SDK’sının bilgisayarınızda kurulu olması gerekiyor. Bu sebeple hangi platform ya da platformlar üzerinden proje oluşturacaksanız, bilgisayarınızda bu SDK’ların bulunması ve tanımlanmış olması gerekiyor.

5. Yeni Cordova uygulaması nasıl oluşturulur?

Uygulamayı hangi dizinde oluşturmak istiyorsanız o dizine gidin ve aşağıdaki komut satırını çalıştırın.

cordova create hello com.example.hello HelloWorld

“cordova create” komutundan sonra gelen ilk parametre “hello” projenizin bulunacağı dizinin adını belirtir. İkinci parametre olan “com.example.hello”, reverse domain-style da denilen ters domain stili bir tanımlayıcıdır. Bu yazım şekli özellikle Java ile çalışmış olanlar için oldukça aşina olacakları bir yazım şeklidir. “HelloWorld” şeklindeki son paratre ise projenizin adını oluşturur. Yukarıdaki bu yazım şeklinin sonuna aşağıki gibi “-d” parametresini eklerseniz komutun o anda hangi işlevleri gerçekleştirdiğini belirten bilgi mesajları alabilirsiniz.

cordova create hello com.example.hello HelloWorld -d

Ancak 2. ve 3. parametreleri kullanmak isteğe bağlıdır. Dilerseniz projenizi aşağıdaki gibi de oluşturabilirsiniz.

cordova create hello

Ama benim tavsiyem işlemlerinizi daha bilinçli gerçekleştirmek adına ilk yazım şeklini kullanmanızdır.

6. Cordova uygulamasına platform nasıl eklenir?

Uygulamanızı oluşturduktan sonra ilk iş olarak hangi platform ya da platformlarda çalışacaksanız o platformları projenize dahil etmeniz, işlemi gerçekleştirmek için ise oluşturduğunuz proje dizininin içerisine girmeniz gerekiyor. Bu işlemi yaptıktan sonra platform ekleme komutlarını aşağıdaki gibi kullanabilirsiniz.

cordova platform add android
cordova platform add ios
cordova platform add amazon-fireos
cordova platform add blackberry10
cordova platform add firefoxos
cordova platform add wp7
cordova platform add wp8
cordova platform add windows8

Not: Hangi platformu hangi işletim sisteminde kullanabileceğiniz ile ilgili bilgiyi Cordova dokümantasyonundaki “Platform Guides” başlığından öğrenebilirsiniz.

7. Cordova uygulamasından platform nasıl silinir?

Bunun için platform ekleme ile aynı yazım şekli kullanılıyor diyebiliriz. Projenizde kurulu bir platformu kaldırmak için;

cordova platform rm ios

ya da

cordova platform remove ios

yazım şeklini kullanabilirsiniz.

Birden fazla platformu aynı anda kaldırmak için ise;

cordova platform rm android ios

ya da

cordova platform remove android ios

yazım şeklini kullanabilirsiniz.

8. Cordova uygulamasında kurulu platformlar nasıl listelenir?

Eğer proje klasörünüzdeki “platforms“ klasörüne bakmayıp CLI kullanacaksanız bunu aşağıdaki gibi yapmanız gerekiyor.

cordova platform ls

ya da

cordova platform list

yazım şeklini kullanabilirsiniz.

Daha da kısaltmak istiyorsanız;

cordova platforms

şeklinde kullanabilirsiniz.

Bu komutları çalıştırdığınızda karşınıza aşağıdaki gibi bir liste gelecektir.

Installed platforms:
Available platforms: android, blackberry10, firefoxos, ios

Bu listeye göre kullanmakta olduğum MacBook Pro üzerinde “android, blackberry10, firefoxos, ios” platformlarında çalışma yapabileceğimi (Available platforms) ama projem için kurulmuş herhangi bir platform olmasını görebiliryorum. (Installed platforms)

9. Kurulu olan Cordova sürümü nasıl öğrenilir?

Çalıştığınız projede kullandığınız Cordova sürümünü öğrenmek için aşağıdaki iki komuttan birini kullanabilirsiniz.

cordova -version

ya da

cordova -v

10. Cordova sürümünü nasıl güncellersiniz?

Yeni bir Cordova kütüphanesi çıktığında, yayınlanan en son sürümü CLI ile sisteminizdeki Cordova sürümünü güncelleyebilirsiniz. Bunun için aşağıdaki komutu kullanabilirsiniz.

npm update -g cordova

Ya da uygulamanızda belli bir platforma göre de aşağıdaki gibi güncelleyebilirsiniz.

cordova platform update android

veya

cordova platform up android

11. İstediğiniz Cordova sürümünü nasıl yüklersiniz?

Bazen özellikle belli bir Cordova sürümü üzerinde çalışmak isteyebilirsiniz. Bunun için ilgili Cordova sürümünü sisteminize yüklemeniz gerekebilir. Bunun için aşağıdaki komutu kullanabilirsiniz.

npm install -g cordova@3.0.0

Bu komut Cordova 3.0.0 sürümünü sisteminize yükler. Eğer farklı bir sürüm yüklemek istiyorsanız yalnızca sürüm numarasını değiştirerek komutu yeniden çalıştırmanız yeterlidir.

12. Cordova pluginleri nasıl yüklenir?

Cordova API’lerinden hangisini kullanmak istiyorsanız bu pluginleri yüklemeniz gerekiyor. Bunun için aşağıdaki komut satırını kullanabilirsiniz.

cordova plugin add <adres>

Örneğin; Device API’yi kullanmak için komut satırı şu şekilde olmalıdır.

cordova plugin add org.apache.cordova.device

13. Cordova pluginleri nasıl kaldırılır?

Uygulamanızda kullandığınız pluginlerden herhangi birine artık ihtiyacınız kalmamış ise bunu aşağıdaki komut satırı ile kaldırabilirsiniz.

cordova plugin remove <adres>

Device API için cordova plugin remove org.apache.cordova.device

ya da

cordova plugin rm <adres>

şeklinde de yazabilirsiniz.

14. Kurulu olan Cordova pluginleri nasıl listelenir?

Uygulamanız için kurduğunu tüm pluginleri liste şeklinde görmek istiyorsanız, aşağıdaki komut satırını kullanabilirsiniz.

cordova plugin ls

ya da

cordova plugin list

15. Proje, tüm platformlar için nasıl hazır hale getirilir?

Ana root içerisinde yapmış olduğunuz çalışmalarınızı istediğiniz platform ya da projenize eklediğiniz tüm platformlar için hazır hale getirir. Böylece Android platformu için hazırlanan bölümü (root>platforms>android) Eclipse ile açıp kullanabilirsiniz.

İşlemi tüm platformlarda çalıştırmak için projenin içerisindeyken;

cordova prepare

belirli bir platform için çalıştırmak istediğinizde

cordova prepare android

şeklinde kullanabilirsiniz.

Not: Bu işlem ana root içerisinde yaptığınız işlemleri platformlar içerisine kopyaladığı için platform altında özel bir işlem yaptıysanız bu dosyalarınızı ezecektir. Unutmayın!

16. Tüm platformlar için nasıl derleme işlemi yapılır?

Uygulamanıza eklediğiniz her platform için derleme işlemi gerçekleştirir.

İşlemi tüm platformlarda çalıştırmak için projenin içerisindeyken;

cordova compile

belirli bir platform için çalıştırmak istediğinizde

cordova compile android

şeklinde kullanabilirsiniz.

17. Tüm platformlar için nasıl inşa işlemi yapılır?

Aslında burada kastettiğimiz build/inşa işlemi, prepare ve compile işlemlerinin tek komut ile aynı anda çalıştırılması anlamına geliyor.

İşlemi tüm platformlarda çalıştırmak için projenin içerisindeyken;

cordova build

belirli bir platform için çalıştırmak istediğinizde

cordova build android

şeklinde kullanabilirsiniz.

18. Uygulamanızı lokal bir sunucuda nasıl çalıştırırsınız?

Cordova ile hazırlamış olduğunu uygulamayı test için lokal bir web sunucu üzerinde çalıştırabilirsiniz. Bu Mac üzerinde bir Apache Tomcat olabildiği gibi, Windows üzerinde bir IIS lokal sunucusu olabilir. Dikkat edilmesi gereken tek konu varsayılan portun 8000 olmasıdır.

Uygulamanızı çalıştırmak için

cordova serve

ya da belli bir platfromda çalıştırmak için

cordova serve android

şeklinde kullanabilirsiniz.

Bu işlemi gerçekleştirdikten sonra tarayıcınıza http://localhost:8000/ url’sini yazarsanız karşınıza uygulamanız ile ilgili çeşitli bilgiler çıkacaktır. Hangi ortam için çalıştırmak istiyorsanız onun linkine tıklayıp, uygulamanızı tarayıcı üzerinden görüntüleyebilirsiniz.

19. Uygulamanızı cihaz üzerinde nasıl çalıştırırsınız?

Uygulamalarınızı test etmenin en güzel yolu şüphesiz gerçek bir cihaz üzerinde test etmektir. CLI ile cihaz üzerinde test işlemi için aşağıdaki kod satırını kullanabilirsiniz.

cordova run (platform)

Örneğin Android platformu için kod satırımız aşağıdaki gibi olmalıdır.

cordova run android

Not: Bu işlemin gerçekleşmesi için bilgisayarınıza USB üzerinden Android işletim sistemli bir cihazın takılmış olması gerektiğini unutmayın!

20. Uygulamanızı emülatör üzerinde nasıl çalıştırırsınız?

Uygulamanızı test etmenin bir diğer yolu da emülatörleri kullanmaktır. Bunun için aşağıdaki komut satırını kullanabilirsiniz.

cordova emulate (platform)

Örneğin Android platformu için kod satırımız aşağıdaki gibi olmalıdır.

cordova emulate android

Not: Bir emülatörü bu şekilde çalıştırmak için öncesinde ilgili platforma gerekli emülatör tanımlamalarının yapılmış olması gerekir. Örneğin; Android platformu için kurulu emülatörleri android list avd komut satırı ile öğrenebilirsiniz.

21. Komutları unuttum, nasıl hatırlarım?

Her insan unutur, normaldir. Bu durumda aşağıdaki komut satırını çalıştırmanız yeterlidir.

cordova help

22. Yapılan işlemleri daha detaylı görmek istiyorum, ne yapabilirim?

Buraya kadar bahsetmiş olduğumuz pek çok işlemin detaylarını merak ediyorsanız komut satısınızın sonuna

-d ya da —verbose parametrelerini kullanabilirsiniz.

Benzer Yazılar


DeliPenguen'i Google+'da bulun



  1. 4 Nisan 2016 - 03:12

    Önemli bir paylaşım. Emeğinize sağlık.