Xamarin.Android-alkalmazás létrehozása

Áttekintés

Ez az oktatóanyag azt ismerteti, hogyan adhat felhőalapú háttérszolgáltatásokat Xamarin.Android-alkalmazásokhoz. További információ: Mi a Mobile Apps szolgáltatás?.

A kész alkalmazásról az alábbiakban látható egy képernyőkép:

Az oktatóanyag végrehajtása feltétele a Mobile Apps Xamarin.Android-alkalmazásokra vonatkozó összes többi oktatóanyag elérésének.

Előfeltételek

Az oktatóanyag teljesítéséhez a következő előfeltételekre lesz szüksége:

Azure Mobile Apps-háttéralkalmazás létrehozása

Mobile Apps-háttéralkalmazás létrehozásához tegye a következőket.

  1. Jelentkezzen be az Azure Portalra.

  2. Kattintson az Erőforrás létrehozása elemre.

  3. A keresőmezőbe írja be a Webalkalmazás kifejezést.

  4. Az eredmények listájában válassza a Webalkalmazás lehetőséget a Marketplace-en.

  5. Válassza ki az előfizetést és az erőforráscsoportot (válasszon ki egy meglévő erőforráscsoportot , vagy hozzon létre egy újat (ugyanazzal a névvel, mint az alkalmazás)).

  6. Válassza ki a webalkalmazás egyedi nevét .

  7. Válassza az alapértelmezett Közzététel lehetőséget Kódként.

  8. A Futtatókörnyezet veremben ki kell választania egy verziót a ASP.NET vagy a Node alatt. Ha .NET-háttérrendszert hoz létre, válasszon egy verziót a ASP.NET területen. Ellenkező esetben, ha csomópontalapú alkalmazást céloz meg, válassza ki az egyik verziót a Node-ból.

  9. Válassza ki a megfelelő operációs rendszert( Linux vagy Windows).

  10. Válassza ki azt a régiót , ahol üzembe szeretné helyezni az alkalmazást.

  11. Válassza ki a megfelelő App Service tervet, majd kattintson az Áttekintés gombra, és hozza létre.

  12. Az Erőforráscsoport területen válasszon ki egy meglévő erőforráscsoportot, vagy hozzon létre egy újat (ugyanazzal a névvel, mint az alkalmazás).

  13. Kattintson a Létrehozás lehetőségre. Várjon pár percet, amíg a szolgáltatás telepítése sikeresen befejeződik, mielőtt továbblépne. Az állapotfrissítéseket az Értesítések (harang) ikonja jelzi a portál fejlécén.

  14. Az üzembe helyezés befejezése után kattintson az Üzembe helyezés részletei szakaszra, majd a Microsoft.Web/sites típusú erőforrásra. Ekkor megnyílik az imént létrehozott App Service webalkalmazás.

  15. Kattintson a Beállítások területen a Konfiguráció panelre, majd az Alkalmazásbeállítások területen kattintson az Új alkalmazásbeállítás gombra.

  16. Az Alkalmazás hozzáadása/szerkesztése lapon adja meg a NevetMobileAppsManagement_EXTENSION_VERSION és az Értéket a legújabbként , majd kattintson az OK gombra.

Mindannyian úgy vannak beállítva, hogy ezt az újonnan létrehozott App Service-webalkalmazást mobilalkalmazásként használják.

Már kiépített egy Azure Mobile Apps-háttérszolgáltatást, amelyet mobil ügyfélalkalmazásai használni tudnak. A következő lépésben le kell töltenie egy kiszolgálóprojektet egy egyszerű „Teendőlista” háttéralkalmazáshoz, és közzé kell tennie az Azure-ban.

Adatbázis-kapcsolat létrehozása és az ügyfél- és kiszolgálóprojekt konfigurálása

  1. Töltse le az ügyféloldali SDK rövid útmutatóit a következő platformokhoz:

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

    Megjegyzés

    Ha az iOS-projektet használja, le kell töltenie az "azuresdk-iOS-*.zip" fájlt a Legújabb GitHub-kiadásból. Bontsa ki és adja hozzá a MicrosoftAzureMobile.framework fájlt a projekt gyökeréhez.

  2. Hozzá kell adnia egy adatbázis-kapcsolatot, vagy csatlakoznia kell egy meglévő kapcsolathoz. Először döntse el, hogy létrehoz-e adattárat, vagy használ egy meglévőt.

    • Új adattár létrehozása: Ha adattárat szeretne létrehozni, használja az alábbi rövid útmutatót:

      Rövid útmutató: Az önálló adatbázisok használatának első lépései az Azure SQL Database-ben

    • Meglévő adatforrás: Ha meglévő adatbázis-kapcsolatot szeretne használni, kövesse az alábbi utasításokat

      1. SQL Database kapcsolati sztring formátuma –Data Source=tcp:{your_SQLServer},{port};Initial Catalog={your_catalogue};User ID={your_username};Password={your_password}

        {your_SQLServer} A kiszolgáló neve, amely az adatbázis áttekintő lapján található, és általában "server_name.database.windows.net" formátumú. {port} általában 1433. {your_catalogue} Az adatbázis neve. {your_username} Az adatbázis eléréséhez szükséges felhasználónév. {your_password} Az adatbázis eléréséhez szükséges jelszó.

        További információ az SQL kapcsolati sztring formátumáról

      2. Adja hozzá a kapcsolati sztring a mobilalkalmazáshoz A App Service a menü Konfiguráció lehetőségével kezelheti az alkalmazás kapcsolati sztringeit.

        Kapcsolati sztring hozzáadása:

        1. Kattintson az Alkalmazásbeállítások fülre.

        2. Kattintson az [+] Új kapcsolati sztring elemre.

        3. Meg kell adnia a nevet, az értéket és a típust a kapcsolati sztring.

        4. Írja be a nevet a következőképpen: MS_TableConnectionString

        5. Az értéknek az előző lépésben létrehozott kapcsolati sztringnek kell lennie.

        6. Ha kapcsolati sztring ad hozzá egy SQL Azure-adatbázishoz, válassza az SQLAzure típust.

  3. Az Azure Mobile Apps .NET-hez és Node.js háttérrendszerhez készült SDK-kkal rendelkezik.

    • Node.js háttérrendszer

      Ha Node.js gyorsindítási alkalmazást fogja használni, kövesse az alábbi utasításokat.

      1. A Azure Portal lépjen az Egyszerű táblázatok elemre, és ezt a képernyőt fogja látni.

        Egyszerű csomóponttáblák

      2. Győződjön meg arról, hogy az SQL-kapcsolati sztring már hozzá van adva a Konfiguráció lapon. Ezután jelölje be a jelölőnégyzetet, és nyugtázza, hogy ez felülírja az összes webhelytartalmat, és kattintson a TodoItem tábla létrehozása gombra.

        Csomópontok egyszerű tábláinak konfigurálása

      3. Az Egyszerű táblázatokban kattintson a + Hozzáadás gombra.

        Node Easy Tables Add Button

      4. Hozzon létre egy táblát TodoItem névtelen hozzáféréssel.

        Egyszerű csomóponttáblák – Táblázat hozzáadása

    • .NET-háttérrendszer

      Ha a .NET gyorsindítási alkalmazást fogja használni, kövesse az alábbi utasításokat.

      1. Töltse le az Azure Mobile Apps .NET-kiszolgálóprojektet az azure-mobile-apps-quickstarts adattárból.

      2. Hozza létre helyileg a .NET-kiszolgálóprojektet a Visual Studióban.

      3. A Visual Studióban nyissa meg Megoldáskezelő, kattintson a jobb gombbal a projektreZUMOAPPNAMEService, kattintson a Közzététel parancsra, és megjelenik egy Publish to App Service ablak. Ha Mac gépen dolgozik, itt további módszereket is használhat az alkalmazás üzembe helyezéséhez.

        Visual Studio-közzététel

      4. Jelölje ki App Service közzétételi célként, majd kattintson a Meglévő kijelölése, majd az ablak alján található Közzététel gombra.

      5. Először az Azure-előfizetésével kell bejelentkeznie a Visual Studióba. Válassza ki a Subscription, Resource Groupmajd az alkalmazás nevét. Ha elkészült, kattintson az OK gombra, ezzel üzembe helyezi a helyileg telepített .NET-kiszolgálóprojektet a App Service háttérrendszerben. Amikor az üzembe helyezés befejeződik, a rendszer átirányítja http://{zumoappname}.azurewebsites.net/ a böngészőben.

A Xamarin.Android alkalmazás futtatása

  1. Nyissa meg a Xamarin.Android projektet.

  2. Lépjen a Azure Portal, és keresse meg a létrehozott mobilalkalmazást. Overview A panelen keresse meg azt az URL-címet, amely a mobilalkalmazás nyilvános végpontja. Példa : az alkalmazásnév "test123" helyneve lesz https://test123.azurewebsites.net.

  3. Nyissa meg a fájlt ToDoActivity.cs ebben a mappában : xamarin.android/ZUMOAPPNAME/ToDoActivity.cs. Az alkalmazás neve .ZUMOAPPNAME

  4. Az osztályban ToDoActivity cserélje le ZUMOAPPURL a változót a fenti nyilvános végpontra.

    const string applicationURL = @"ZUMOAPPURL";

    Lesz

    const string applicationURL = @"https://test123.azurewebsites.net";

  5. Az alkalmazás üzembe helyezéséhez és futtatásához nyomja le az F5 billentyűt.

  6. Az alkalmazásban írjon be értelmes szöveget, például töltse ki az oktatóanyagot , majd kattintson a Hozzáadás gombra.

    A rendszer beilleszti kérés adatait a TodoItem táblába. A táblázatban tárolt elemeket a mobil-háttéralkalmazás visszaküldi, és az adatok megjelennek a listában.

    Megjegyzés

    A mobil-háttéralkalmazás számára az adatok lekérdezéséhez és beszúrásához hozzáférést biztosító kódot a ToDoActivity.cs C# fájlban tekintheti meg.

Hibaelhárítás

Ha a megoldás elkészítése során problémákat tapasztal, futtassa a NuGet csomagkezelőt, és frissítse a Xamarin.Android támogatási csomagokat. Előfordulhat, hogy a gyorsindítási projektek nem tartalmazzák a legújabb verziót.

Vegye figyelembe, hogy a projektjében hivatkozott összes támogatási csomagnak azonos verziójúnak kell lennie. Az Azure Mobile Apps NuGet csomag Android platform esetén Xamarin.Android.Support.CustomTabs-függőséggel rendelkezik, így ha a projektjében újabb támogatási csomagokat használ, akkor az ütközések elkerülése érdekében közvetlenül kell telepítenie ennek a csomagnak a szükséges verzióját.