Inhoud
- Wat vooraf ging
- Een Xamarin-project starten
- Uw Xamarin.Forms-project updaten
- De werkomgeving instellen
- Uw project starten/debuggen
- Een aangemaakt Visual Studio project openen
Wat vooraf ging
In deze post bespreken we hoe u een Xamarin-project opstart en Visual Studio klaar maakt om te werken met Xamarin.
Uiteraard moet Visual Studio reeds geïnstalleerd zijn, is dit niet het geval dan kunt u hier lezen hoe u Visual Studio en Xamarin kunt installeren.
Om Visual Studio Community gratis te kunnen blijven gebruiken moet u zich aanmelden met uw Microsoft-account. Is dit nog niet het geval dan krijgt u een melding en kunt u zich alsnog aanmelden met uw Microsoft-account. Ik ga ervan uit dat dit gebeurd is.
Maar voor we starten met Xamarin, neem eens een kijkje naar onderstaande video’s, ze tonen:
- hoe u Visual Studio installeert en een eerste keer gebruikt.
- hoe u een (console) project start.
- hoe u Visual Studio uitbreidt met extensies en updates.
- hoe u de omgeving van Visual Studio (de IDE) gebruikt.
- Installatie van Xamarin (overzicht).
Visual Studio installeren en een eerste keer gebruiken
Een (console) project starten
Visual Studio uitbreiden met extensies en updates
De bouwstenen van de Visual Studio IDE (Integrated Development Environment)
Installatie van Xamarin
Windows 10 in ontwikkelaarsmodus
Vergeet niet eerst uw Windows 10 in de ontwikkelaarsmodus te zetten.
- U vindt dit via Instellingen – Bijwerken en beveiliging – Voor ontwikkelaars.
- Duidt Modus voor ontwikkelaars aan.
Een Xamarin-project starten
- Start Visual Studio (2017 Community).
- Creëer een nieuw project via File – New – Project….
- Selecteer Templates – Visual C# – Cross Platform – Cross Platform App (Xamarin.Forms or Native). In Visual Studio 2017 noemt dit Mobile App (Xamarin.Forms).
- Geef een gepaste naam (de Solution name is normaal dezelfde naam) en wijzig eventueel de locatie en klik op OK.
Maak de gewenst keuze. Wij gaan (meestal) voor:
- Blank App
- Selecteer welke projecten u wilt bouwen (Android, iOS, Windows)
- Code Sharing Strategy: kies .NET Standard.
- Klik op OK.
Het project wordt gecreëerd.
- Selecteer de gewenst UWP-versie. Laat gewoon de standaard keuzes staan. Wilt u meer weten over de geschikte versie, lees het dan hier.
- Klik op OK om verder te gaan.
- Voeg eventueel een Mac toe voor het programmeren van iOS apps. Omdat ik geen Mac ter beschikking heb ga ik me beperken tot UWP (Windows 10) en Android. Lees hier hoe u eventueel uw Mac kunt toevoegen.
- Klik op Close.
- Uw Xamarin-project is aangemaakt.
Uw Xamarin.Forms-project updaten
Het gecreëerde Xamarin-project staat niet meteen in de meest recente update (spijtig). Het is aan te raden het project meteen te updaten voor u begint.
We gaan het volledige project (de volledige solution) updaten.
- Klik rechts op de Solution.
- Klik op Get NuGet Packages for Solution….
U krijgt een overzicht van alle geïnstalleerde “packages”. U ziet ook hoeveel updates er beschikbaar zijn (in onderstaand voorbeeld 10).
- Klik op Updates.
U hoeft niet noodzakelijk alles te selecteren, de praktijk heeft me geleerd dat alles updaten tot fouten kan leiden. We gaan enkel Xamarin.Forms updaten.
- Selecteer Xamarin.Forms. U ziet de huidige geïnstalleerde versie en de laatste stabiele versie.
- Klik op Install (of bovenaan op Update).
- U krijgt een overzicht van de updates, bevestig dit met OK.
Het kan nodig zijn dat u Visual Studio opnieuw opstart.
- Sluit Visual Studio en start het opnieuw op door te klikken op Restart.
De update is uitgevoerd.
De werkomgeving instellen
De gewenste toolbars toevoegen
Ik heb standaard onderstaande toolbars geïnstalleerd.
Het project configureren
- Klik op Build – Configuration Manager….
- Hier kunt u aanvinken welke projecten moeten gebouwd (build) en “in gebruik genomen” (deployed) worden. UWP en iOS zijn standaard niet aangevinkt. Ik heb eveneens UWP aangevinkt, wie ook een iOS wilt aanmaken kan ook dit aanvinken. Merk op, omdat ik geen Apple in mijn netwerk heb kan ik wel iOS bouwen maar niet “deployen”.
- Klik op Close om het venster te sluiten.
Uw project starten/debuggen
- Kies op welk platform u het project wilt starten.
Android
- Kies op welk toestel u het project wilt starten. Hebt u uw eigen Android toestel aangesloten dan vindt u dit toestel ook terug in deze lijst. Ik heb dit niet gedaan en zie enkel de geïnstalleerde emulators.
- Maak de keuze en klik eventueel opnieuw op de knop om het project te starten op uw gekozen platform.
Na wat geduld krijgt u het onderstaande te zien.
Uw eerste Xamarin.Forms programma is opgestart op de Android-emulator en heet u welkom.
- Sluit het programma (het debuggen) en sluit eventueel ook de emulator (met het kruisje rechtsboven).
UWP (Windows 10)
U kunt het project ook starten onder Windows 10. Als u veel tijd hebt kiest u voor de “Simulator”, anders kunt u ook gaan voor “Local Machine”.
- Ik kies voor “Local Machine”.
- En kijk, ook op Windows 10 zijn we welkom.
iOS
iOS kunt u enkel starten als u een Apple hebt aangesloten (wat ik niet gedaan heb).
Unlock uw Android-toestel voor gebruik als ontwikkelaar
Om uw Android toestel te kunnen gebruiken als uitvoer (“deploy”) volgt u onderstaande stappen:
- Ga naar Instellingen – Meer – Toestel-info.
- Klik 7 keer op Kernel-versie.
- Ga terug naar het vorig menu. Hier staat nu een nieuwe optie bij: Ontwikkelaarsopties.
- Klik USB foutopsporing aan.
- Klik apps verifiëren via USB aan.
- Sluit uw Android-toestel aan op uw computer.
Uw toestel komt nu in Visual Studio Xamarin als keuzeoptie.
Een aangemaakt Visual Studio project openen
Eens het project aangemaakt is kunt u het eenvoudig vanuit Visual Studio opnieuw openen.
- Start Visual Studio 2017.
- U vindt een recent aangemaakt project wellicht terug onder Recent.
- Of u kunt het gaan opzoeken via File – Open – Project/Solution… en het project/solution op te zoeken in de opgeslagen map.
- U kunt ook gemakkelijker een nieuw Xamarin-project starten via Recent project templates. U vindt daaronder het template van Cross Platform App (Xamarin.Forms).
Behandelde Basiscompetenties uit de module ICT Programmeren – Specifieke ontwikkelomgeving: eenvoudige functionaliteiten
- IC BC017 – kan ICT veilig en duurzaam gebruiken
- IC BC241 – kan een programma in een specifieke ontwikkelomgeving maken
- IC BC249 – kan de instellingen van een specifieke ontwikkelomgeving wijzigen
- IC BC288 – kan ICT-problemen oplossen
