Apache Cordova uygulaması oluşturma

Genel Bakış

Bu öğreticide, bir Apache Cordova mobil uygulamasına Azure mobil uygulaması arka ucunu kullanarak bulut tabanlı arka uç hizmetini nasıl ekleyeceğiniz gösterilir. Yeni bir mobil uygulama arka ucu ve uygulama verilerini Azure'da depolayan basit bir Yapılacaklar listesi Apache Cordova uygulaması oluşturacaksınız.

Bu öğreticiyi tamamlamak, Azure App Service’de Mobile Apps özelliğini kullanmayla ilgili diğer tüm Apache Cordova öğreticileri için ön koşuldur.

Önkoşullar

Bu öğreticiyi tamamlamak için aşağıdaki önkoşulları karşılamanız gerekir:

Ayrıca Visual Studio’yu atlayabilir ve doğrudan Apache Cordova komut satırını kullanabilirsiniz. Komut satırını kullanmak, öğreticiyi bir Mac bilgisayarda tamamladığınızda kullanışlıdır. Komut satırını kullanarak Apache Cordova istemci uygulamalarını derleme bu öğretici kapsamında değildir.

Azure mobil uygulama arka ucu oluşturma

  1. Azure Portal’ında oturum açın.

  2. Kaynak oluştur'a tıklayın.

  3. Arama kutusuna Web App yazın.

  4. Sonuçlar listesinde Market'ten Web Uygulaması'nı seçin.

  5. Aboneliğinizi ve Kaynak Grubunuzu seçin (mevcut bir kaynak grubunu seçin veya yeni bir tane oluşturun (uygulamanızla aynı adı kullanarak)).

  6. Web uygulamanızın benzersiz bir Adını seçin.

  7. Varsayılan Kod Olarak Yayımla seçeneğini belirleyin.

  8. Çalışma zamanı yığınında, ASP.NET veya Node altında bir sürüm seçmeniz gerekir. .NET arka ucu oluşturuyorsanız ASP.NET altında bir sürüm seçin. Aksi takdirde Düğüm tabanlı bir uygulamayı hedefliyorsanız Node'dan bir sürüm seçin.

  9. Linux veya Windows gibi doğru İşletim Sistemini seçin.

  10. Bu uygulamanın dağıtılması istediğiniz Bölgeyi seçin.

  11. Uygun plan App Service seçin ve Gözden geçir ve oluştur'a tıklayın.

  12. Kaynak Grubu'nun altında mevcut bir kaynak grubunu seçin veya yeni bir tane oluşturun (uygulamanızla aynı adı kullanarak).

  13. Oluştur’a tıklayın. Devam etmeden önce hizmetin sorunsuz dağıtılması için birkaç dakika bekleyin. Durum güncelleştirmeleri için portal üst bilgisindeki Bildirimler (zil) simgesini izleyin.

  14. Dağıtım tamamlandıktan sonra Dağıtım ayrıntıları bölümüne tıklayın ve ardından Microsoft.Web/sites Türünde Kaynak'a tıklayın. Yeni oluşturduğunuz App Service Web Uygulamasına gidersiniz.

  15. Ayarlar'ın altındaki Yapılandırma dikey penceresine tıklayın ve Uygulama ayarlarındaYeni uygulama ayarı düğmesine tıklayın.

  16. Uygulama ekle/düzenle ayarı sayfasında, MobileAppsManagement_EXTENSION_VERSION olarak Ad ve en son olarak Değer girin ve Tamam'a basın.

Bu yeni oluşturulan App Service Web uygulamasını Mobil uygulama olarak kullanmaya hazırsınız.

Veritabanı bağlantısı oluşturma ve istemci ile sunucu projesini yapılandırma

  1. Aşağıdaki platformlar için istemci SDK hızlı başlangıçlarını indirin:

    iOS (Objective-C)
    iOS (Swift)
    Android (Java)
    Xamarin.iOS
    Xamarin.Android
    Xamarin.Forms
    Cordova
    Windows (C#)

    Not

    iOS projesini kullanıyorsanız en son GitHub sürümünden "azuresdk-iOS-*.zip" indirmeniz gerekir. Dosyanın sıkıştırmasını MicrosoftAzureMobile.framework açın ve projenin köküne ekleyin.

  2. Veritabanı bağlantısı eklemeniz veya var olan bir bağlantıya bağlanmanız gerekir. İlk olarak veri deposu oluşturup oluşturmayacağınızı veya var olan bir depo kullanıp kullanmayabileceğinizi belirleyin.

    • Yeni veri deposu oluşturma: Veri deposu oluşturacaksanız aşağıdaki hızlı başlangıcı kullanın:

      Hızlı Başlangıç: Azure SQL Veritabanında tek veritabanlarını kullanmaya başlama

    • Mevcut veri kaynağı: Mevcut bir veritabanı bağlantısını kullanmak istiyorsanız aşağıdaki yönergeleri izleyin

      1. SQL Veritabanı Bağlantı Dizesi biçimi -Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}

        {your_SQLServer} Sunucunun adı, veritabanınızın genel bakış sayfasında bulunabilir ve genellikle "server_name.database.windows.net" biçimindedir. {port} genellikle 1433. {your_catalogue} Veritabanının adı. {your_username} Veritabanınıza erişmek için kullanıcı adı. {your_password} Veritabanınıza erişmek için parola.

        SQL Bağlantı Dizesi biçimi hakkında daha fazla bilgi edinin

      2. Bağlantı dizesini mobil uygulamanıza ekleme App Service'da, menüdeki Yapılandırma seçeneğini kullanarak uygulamanız için bağlantı dizelerini yönetebilirsiniz.

        Bağlantı dizesi eklemek için:

        1. Uygulama ayarları sekmesine tıklayın.

        2. [+] Yeni bağlantı dizesi'ne tıklayın.

        3. Bağlantı dizeniz için Ad, Değer ve Tür sağlamanız gerekir.

        4. Tür Adı:MS_TableConnectionString

        5. Değer, önceki adımda oluşturduğunuz bağlantı dizesi olmalıdır.

        6. SQL Azure veritabanına bağlantı dizesi ekliyorsanız, türün altında SQLAzure'ı seçin.

  3. Azure Mobile Apps'te .NET için SDK'lar ve arka uçlar Node.js vardır.

    • Arka ucuNode.js

      Node.js hızlı başlangıç uygulamasını kullanacaksanız aşağıdaki yönergeleri izleyin.

      1. Azure portal Kolay Tablolar'a gidin, bu ekranı görürsünüz.

        Düğüm Kolay Tabloları

      2. SQL bağlantı dizesinin Yapılandırma sekmesine zaten eklendiğinden emin olun. Ardından, bunun tüm site içeriğinin üzerine yazılacağını kabul ediyorum kutusunu işaretleyin ve TodoItem tablosu oluştur düğmesine tıklayın.

        Düğüm Kolay Tablo Yapılandırması

      3. Kolay Tablolar'da+ Ekle düğmesine tıklayın.

        Düğüm Kolay Tablolar Ekle Düğmesi

      4. Anonim erişimli bir TodoItem tablo oluşturun.

        Düğüm Kolay Tabloları Tablo Ekle

    • .NET arka ucu

      .NET hızlı başlangıç uygulamasını kullanacaksanız aşağıdaki yönergeleri izleyin.

      1. azure-mobile-apps-quickstarts deposundan Azure Mobile Apps .NET sunucu projesini indirin.

      2. .NET sunucu projesini Visual Studio'da yerel olarak oluşturun.

      3. Visual Studio'da Çözüm Gezgini açın, projeye sağ tıklayınZUMOAPPNAMEService, Yayımla'ya tıklayın, bir Publish to App Service pencere görürsünüz. Mac üzerinde çalışıyorsanız, uygulamayı burada dağıtmanın diğer yollarını gözden geçirin.

        Visual Studio yayımlama

      4. Yayımlama hedefi olarak App Service seçin, ardından Var Olanı Seç'e tıklayın, ardından pencerenin en altındaki Yayımla düğmesine tıklayın.

      5. Önce Azure aboneliğinizle Visual Studio'da oturum açmanız gerekir. Subscription, ve Resource Groupardından uygulamanızın adını seçin. Hazır olduğunuzda Tamam'a tıklayın; bu işlem yerel olarak sahip olduğunuz .NET sunucu projesini App Service arka ucuna dağıtır. Dağıtım tamamlandığında, tarayıcıda adresine http://{zumoappname}.azurewebsites.net/ yönlendirilirsiniz.

Apache Cordova uygulamasını indirme ve çalıştırma

  1. İstemci projesinde (.sln) çözüm dosyasına gidin ve Visual Studio'yu kullanarak açın.

  2. Visual Studio'da başlatma okunun yanındaki açılır menüden çözüm platformunu (Android, iOS veya Windows) seçin. Yeşil ok üzerindeki açılır menüye tıklayarak belirli bir dağıtım cihazı veya öykünücüyü seçin. Varsayılan Android platformunu ve Ripple öykünücüsünü kullanabilirsiniz. Daha gelişmiş öğreticilerde (anında iletme bildirimleri gibi) desteklenen bir cihazı ve öykünücüyü seçmeniz istenecek.

  3. Dosyayı ToDoActivity.java şu klasörde açın: ZUMOAPPNAME/app/src/main/java/com/example/zumoappname. Uygulama adı şeklindedir ZUMOAPPNAME.

  4. Azure portal gidin ve oluşturduğunuz mobil uygulamaya gidin. Dikey pencerede Overview , mobil uygulamanızın genel uç noktası olan URL'yi bulun. Örnek - Uygulama adımın site adı "test123" olacaktır https://test123.azurewebsites.net.

  5. ZUMOAPPNAME/www/js/index.js dosyasındaki dosyaya index.js gidin ve parametresini yukarıdaki genel uç noktayla değiştirinZUMOAPPURL.onDeviceReady()

    client = new WindowsAzure.MobileServiceClient('ZUMOAPPURL');

    Olur

    client = new WindowsAzure.MobileServiceClient('https://test123.azurewebsites.net');

  6. Cordova uygulamanızı derlemek ve çalıştırmak için F5'e basın veya yeşil oka tıklayın. Öykünücüde ağa erişim isteyen bir güvenlik iletişim kutusu görürseniz erişim isteğini kabul edin.

  7. Uygulama cihazda veya öykünücüde başlatıldıktan sonra Yeni metin girin alanına Öğreticiyi tamamla gibi anlamlı bir metin yazın ve ekle düğmesine tıklayın.

Arka uç, istekten alınan verileri SQL Veritabanı'ndaki TodoItem tablosuna ekler ve yeni depolanan öğeler hakkındaki bilgileri de mobil uygulamaya geri döndürür. Mobil uygulama bu verileri listede görüntüler.

Diğer platformlar için 3 ile 5 arasındaki adımları tekrarlayabilirsiniz.