Azure ile Xamarin.Forms uygulaması oluşturma

  • Makale

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.

  • Xamarin için Visual Studio Araçları, Visual Studio 2017 veya sonraki sürümlerinde veya 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 üzeri kullanılabilir (Mac ağdaki kullanılabilir olduğu sürece).

Yeni bir Mobile Apps 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.

Xamarin.Forms çözümünü çalıştırma

Çö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 gidin ve oluşturduğunuz mobil uygulamaya gidin. Dikey pencerede Overview , mobil uygulamanızın genel uç noktası olan URL'yi bulun. Örnek - "test123" uygulama adımın site adı olacaktır https://test123.azurewebsites.net.

  2. Dosyayı Constants.cs şu klasörde açın: xamarin.forms/ZUMOAPPNAME. Uygulama adı şeklindedir ZUMOAPPNAME.

  3. sınıfında Constants.cs değişkeni yukarıdaki genel uç noktayla 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 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

Mobile Apps arka ucunuze 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.