Azure ile Xamarin.Forms uygulaması oluşturma

Genel Bakış

Bu öğreticide, bir Xamarin.Forms mobil uygulamasına bulut tabanlı bir arka uç hizmetini Azure Uygulama Hizmeti’nin Mobile Apps özelliğini kullanarak nasıl ekleyeceğiniz gösterilir. Yeni bir Mobil Uygulama arka ucu ve uygulama verilerini Azure’da depolayan basit bir yapılacaklar listesi Xamarin.Forms uygulaması oluşturacaksınız.

Bu öğreticiyi tamamlamak Xamarin.Forms uygulamalarına ilişkin tüm Mobile Apps öğreticileri için ön koşuldur.

Önkoşullar

Bu öğreticiyi tamamlamak için aşağıdakiler gerekir:

  • Etkin bir Azure hesabı. Bir hesabınız yoksa, Azure deneme sürümünü kaydolabilir ve deneme süresi bittikten sonra dahi kullanmaya devam edebileceğiniz 10 ücretsiz mobil uygulama edinebilirsiniz. Daha fazla bilgi için bkz. Azure Ücretsiz Denemesi.

  • Visual Studio Tools for Xamarin, Visual Studio 2017 veya sonrası veya Daha sonra, mac için Visual Studio. Yönergeler için bkz. Xamarin yükleme sayfası.

  • (isteğe bağlı) iOS uygulaması oluşturmak için, Xcode 9.0 veya üzerine sahip bir Mac gereklidir. Mac için Visual Studio iOS uygulamaları geliştirmek için kullanılabilir veya Visual Studio 2017 veya daha sonra kullanılabilir (Mac ağda kullanılabilir olduğu sürece).

Yeni bir Mobile Apps arka ucu oluşturma

  1. Azure Portal oturum açın.

  2. Kaynak Oluştur'utıklatın.

  3. Arama kutusuna Web Uygulamasıyazın.

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

  5. Abonelik ve Kaynak Grubunuzu seçin (varolan bir kaynak grubu seçin veya yeni bir tane oluşturun (uygulamanızla aynı adı kullanarak)).

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

  7. Varsayılan Kodolarak Yayımla seçeneğini seçin.

  8. Runtime yığınında, ASP.NET veya Düğümaltında bir sürüm seçmeniz gerekir. Bir .NET arka uç oluşturuyorsanız, ASP.NET altında bir sürüm seçin. Aksi takdirde Düğüm tabanlı bir uygulamayı hedefliyorsanız, Düğüm'den sürümden birini seçin.

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

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

  11. Uygun Uygulama Hizmet Planı'nı seçin ve Gözden Geçir'e vurun ve oluşturun.

  12. Kaynak Grubualtında, varolan bir kaynak grubu seçin veya yeni bir tane oluşturun (uygulamanızla aynı adı kullanarak).

  13. Oluştur'utıklatı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/sitetürü kaynağına tıklayın. Sizi az önce oluşturduğunuz App Service Web App'e yönlendirecektir.

  15. Ayarlar'ın altındaki Yapılandırma bıçağına ve Uygulama ayarlarında Yeni uygulama ayar düğmesine tıklayın.

  16. Ekle/Yap uygulama ayar sayfasında, Ad'ı MobileAppsManagement_EXTENSION_VERSION olarak ve Değer'i en son olarak girin ve Tamam'a basın. Name

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

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

  1. Aşağıdaki platformlar için istemci SDK quickstarts indirin:

    iOS (Amaç-C)
    iOS (Swift)
    Android (Java)
    Xamarin.iOS
    Xamarin.Android
    Xamarin.Forms
    Cordova
    Pencereler (C#)

    Not

    iOS projesini kullanıyorsanız, en son GitHub sürümünden*"azuresdk-iOS- .zip" indirmeniz gerekir. Zip'i açın MicrosoftAzureMobile.framework ve dosyayı projenin köküne ekleyin.

  2. Bir veritabanı bağlantısı eklemeniz veya varolan bir bağlantıya bağlanmanız gerekir. İlk olarak, bir veri deposu oluşturup oluşturmayacağınızı veya varolan bir tane kullanıp kullanmayacağınıbelirleyin.

    • Yeni bir veri deposu oluşturun: Bir veri deposu oluşturacaksanız, aşağıdaki hızlı başlatmayı kullanın:

      Quickstart: Azure SQL Veritabanı'nda tek veritabanları yla başlarken

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

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

        {your_SQLServer} Sunucunun adı, bu veritabanınız için genel bakış sayfasında bulunabilir ve genellikle "server_name.database.windows.net" şeklindedir. {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 Connection String formatı hakkında daha fazla bilgi edinin

      2. Mobil uygulamanıza bağlantı dizesini ekleyin Uygulama Hizmeti'nde, menüdeki Yapılandırma seçeneğini kullanarak uygulamanızın bağlantı dizelerini yönetebilirsiniz.

        Bağlantı dizesi eklemek için:

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

        2. [+] Yeni bağlantı dizesitıklayın.

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

        4. Tür Adı olarakMS_TableConnectionString

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

        6. SQL Azure veritabanına bağlantı dizesi ekliyorsanız, SQLAzure'u yazınaltında seçin. SQLAzure

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

    • Düğüm.js arka uç

      Node.js quickstart uygulamasını kullanacaksanız, aşağıdaki talimatları uygulayın.

      1. Azure portalında Kolay Tablolar'agidin, bu ekranı göreceksiniz.

        Düğüm Kolay Tablolar

      2. SQL bağlantı dizesinin Yapılandırma sekmesine zaten eklenmiştir. Daha sonra bunun tüm site içeriğinin üzerine yazacağını kabul ettiğim kutusunu işaretleyin ve TodoItem tablo oluştur düğmesini tıklatın.

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

      3. Kolay Tablolar'da + Ekle düğmesini tıklatın.

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

      4. Anonim TodoItem erişimi olan bir tablo oluşturun.

        Düğüm Kolay Tablolar Tablo Ekle

    • .NET arka ucu

      .NET quickstart uygulamasını kullanacaksanız, aşağıdaki talimatları uygulayın.

      1. Azure Mobil Uygulamalar .NET sunucu projesini azure-mobile-apps-quickstarts deposundanindirin.

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

      3. Visual Studio'da Çözüm Gezgini'ni ZUMOAPPNAMEService açın, projeye sağ tıklayın, Yayımla'yıtıklatın, bir Publish to App Service pencere göreceksiniz. Mac üzerinde çalışıyorsanız, uygulamayı buradadağıtmanın diğer yollarına göz atın.

        Görsel stüdyo yayıncılığı

      4. Hedef olarak Uygulama Hizmetini seçin, ardından Varolan'ı Seç'itıklatın ve pencerenin altındaki Yayımla düğmesini tıklatın.

      5. Önce Azure aboneliğinizle Visual Studio'ya giriş yapmanız gerekir. 'yi Subscription Resource Groupve uygulamanızın adını seçin. Hazır olduğunuzda, Tamam'ıtıklatın, bu uygulama hizmeti arka ucuna yerel olarak sahip olduğunuz .NET sunucu projesini dağıtacaktır. Dağıtım bittiğinde, tarayıcıya http://{zumoappname}.azurewebsites.net/ yönlendirilirsiniz.

Xamarin.Forms çözümlerini çalıştırın

Çözümü açmak için Xamarin için Visual Studio Araçları gereklidir, bkz. Xamarin yükleme yönergeleri. Araçlar zaten yüklendiyse, çözümü indirip açmak için aşağıdaki adımları izleyin:

Visual Studio (Windows ve Mac)

  1. Azure portalına gidin ve oluşturduğunuz mobil uygulamaya gidin. Bıçakta, Overview mobil uygulamanızın genel bitiş noktası olan URL'ye bakın. Örnek - uygulama adım "test123" için https://test123.azurewebsites.netsite adı olacaktır.

  2. Bu klasördeki dosyayı Constants.cs açın - xamarin.forms/ZUMOAPPNAME. Uygulama ZUMOAPPNAMEadı.

  3. Sınıfta, Constants.cs değişkeni yukarıdaki ortak bitiş noktasıyla değiştirin. ZUMOAPPURL

    public static string ApplicationURL = @"ZUMOAPPURL";

    Olur

    public static string ApplicationURL = @"https://test123.azurewebsites.net";

  4. Android veya Windows projelerini ve ağa bağlı bir Mac bilgisayar varsa iOS projesini çalıştırmak için aşağıdaki yönergeleri izleyin.

(İsteğe bağlı) Android projesi çalıştırma

Bu bölümde Xamarin.Android projesini çalıştırırsınız. Android cihazlarıyla çalışmıyorsanız, bu bölümü atlayabilirsiniz.

Visual Studio

  1. Android (Droid) projesine sağ tıklayın ve ardından Başlangıç Projesi Olarak Ayarla’yı seçin.

  2. Yapı menüsünde, Yapılandırma Yöneticisi’ni seçin.

  3. Yapılandırma Yöneticisi iletişim kutusunda, Android projesinin yanındaki Yapı ve Dağıt onay kutularını seçin ve paylaşılan kod projesinde Yapı kutusunun işaretli olduğundan emin olun.

  4. Projeyi oluşturmak ve uygulamayı Android öykünücüsünde başlatmak için F5 tuşuna basın veya Başlat düğmesine tıklayın.

Mac için Visual Studio

  1. Android projesine sağ tıklayın ve ardından Başlangıç Projesi Olarak Ayarla’yı seçin.

  2. Projeyi oluşturmak ve uygulamayı Android öykünücüsünde başlatmak için Çalıştır menüsünü ve ardından Hata Ayıklamayı Başlat’ı seçin.

Uygulamada, Xamarin öğren gibi anlamlı bir metin yazın ve ardından artı simgesini (+) seçin.

Android yapılacaklar uygulaması

Bu işlem, Azure üzerinde barındırılan yeni Mobile Apps arka ucuna bir post isteği gönderir. İstekten alınan veriler TodoItem tablosuna eklenir. Tabloda depolanan öğeler Mobile Apps arka ucu tarafından döndürülür ve veriler listede görüntülenir.

Not

Mobile Apps arka ucuna erişen kod, çözümün paylaşılan kod projesinin TodoItemManager.cs C# dosyasındadır.

(İsteğe bağlı) iOS projesi çalıştırma

Bu bölümde iOS cihazlarda Xamarin iOS projesi çalıştırırsınız. iOS cihazlarıyla çalışmıyorsanız, bu bölümü atlayabilirsiniz.

Visual Studio

  1. iOS projesine sağ tıklayın ve ardından Başlangıç Projesi Olarak Ayarla’yı seçin.

  2. Yapı menüsünde, Yapılandırma Yöneticisi’ni seçin.

  3. Yapılandırma Yöneticisi iletişim kutusunda, iOS projesinin yanındaki Yapı ve Dağıt onay kutularını seçin ve paylaşılan kod projesinde Yapı kutusunun işaretli olduğundan emin olun.

  4. Projeyi oluşturmak ve uygulamayı iPhone öykünücüsünde başlatmak için F5 tuşuna basın.

Mac için Visual Studio

  1. iOS projesine sağ tıklayın ve ardından Başlangıç Projesi Olarak Ayarla'yıseçin.

  2. Çalıştır menüsünde, Hata Ayıklamayı Başlat’a tıklayarak projeyi oluşturun ve iPhone öykünücüsünde uygulamayı başlatın.

Uygulamada, Xamarin öğren gibi anlamlı bir metin yazın ve ardından artı simgesini (+) seçin.

iOS yapılacaklar uygulaması

Bu işlem, Azure üzerinde barındırılan yeni Mobile Apps arka ucuna bir post isteği gönderir. İstekten alınan veriler TodoItem tablosuna eklenir. Tabloda depolanan öğeler Mobile Apps arka ucu tarafından döndürülür ve veriler listede görüntülenir.

Not

Çözümün paylaşılan kod projesinin TodoItemManager.cs C# dosyasında Mobile Apps arka ucuna erişen kodu bulacaksınız.

(İsteğe bağlı) Windows projesi çalıştırma

Bu bölümde, Windows cihazlar için Xamarin.Forms Evrensel Windows Platformu (UWP) projelerini çalıştırırsınız. Windows cihazlarıyla çalışmıyorsanız, bu bölümü atlayabilirsiniz.

Visual Studio

  1. Herhangi bir UWP projesine sağ tıklayın ve ardından Başlangıç Projesi Olarak Ayarla’yı seçin.

  2. Yapı menüsünde, Yapılandırma Yöneticisi’ni seçin.

  3. Yapılandırma Yöneticisi iletişim kutusunda, seçtiğiniz Windows projesinin yanındaki Yapı ve Dağıt onay kutularını seçin ve paylaşılan kod projesinde Yapı kutusunun işaretli olduğundan emin olun.

  4. Projeyi oluşturmak ve uygulamayı Windows öykünücüsünde başlatmak için F5 tuşuna basın veya Başlat düğmesine (Yerel Makine yazmalıdır) tıklayın.

Not

Windows projesi macOS üzerinde çalıştırılamaz.

Uygulamada, Xamarin öğren gibi anlamlı bir metin yazın ve ardından artı simgesini (+) seçin.

Bu işlem, Azure üzerinde barındırılan yeni Mobile Apps arka ucuna bir post isteği gönderir. İstekten alınan veriler TodoItem tablosuna eklenir. Tabloda depolanan öğeler Mobile Apps arka ucu tarafından döndürülür ve veriler listede görüntülenir.

UWP yapılacaklar uygulaması

Not

Mobil Uygulamalarınıza erişen kodu, çözümünüzün taşınabilir sınıf kitaplığı projesinin TodoItemManager.cs C# dosyasında bulabilirsiniz.

Sorun giderme

Çözümü oluşturma konusunda sorun yaşarsanız, NuGet paket yöneticisini çalıştırıp Xamarin.Forms’in en son sürümüne güncelleştirin ve Android projesinde Xamarin.Android destek paketlerini güncelleştirin. Hızlı Başlangıç projeleri her zaman son sürümleri içermeyebilir.

Android projenizde başvurulan tüm destek paketlerinin aynı sürüme sahip olması gerektiğini unutmayın. Azure Mobile Apps NuGet paketi, Android platformu için Xamarin.Android.Support.CustomTabs bağımlılığına sahiptir, yani projeniz daha yeni destek paketleri kullanıyorsa, çakışmaları önlemek için doğrudan gerekli sürüme sahip bu paketi yüklemeniz gerekir.