XAMARIN

29.03.2021 Svítilna - Blikačka

Na základě tutoriálu Xamarian.Essential jsem vypreparoval aplikaci Blikačka
Funguje OK, tj. zišťuje aktuální stav lampičky + rozvěcí a zhasíná lampičku.
Zajímavý je, že k rozvícení potřebuje právo CAMERA, ale k zhasnutí LIGHTLAMP.
Jenže je zde sada akcí, které bych chtěl a nemám a nevím jak na ně.
Blikat na základě timeru - tj nastavit délku bliku a délku mezery.
Blikat i když není okno aktivní a dokonce i když aplikace není aktivní
Komunikovat s ovládacími prvky Nastavení - Změnit status pokud zhasnu/rozvítím z menu Nastavení.
Jenže moje pokusy o tyto tři rozšíření narážejí na asi moji neznalost Xamarinu, nebo Androidu - prostě Ty příklady co najdu na internetu nefungujou.
Proto jsem si na základě kurzu XAML, který mne naučil základy XAMLu - a tím pádem jsem mohle krásně portovat Blikačku do Template příkladu - zakoupil kurz Xamarin na ITNetwork (petrik@karia.cz/matonka)

1.04.2021 ITNetwork - kurz XAMARIN

Lekce 1 - Úvod do Xamarin

Android (Java/Kotlin), iOS (Swift).
Xamarin.Forms. Platforma pro vytváření nativních aplikací v C#.NET a XAML.
Stačí mít VS2019 s rozšířením Xamarin + Android SDK a Tools (Android SDK Tools, Android SDK Build Tools, Android Emulator)
Ve Windows kvůli emulátoru je třeba povolit Virtuální stroj (Platforma hepervisoru Windows) v Zapnout nebo vypnout funkce systému Windows

Lekce 2 - Struktura Xamarin projektu a životní cyklus aplikace

MainPage.xaml MainPage.xaml.cs. Layout - Rozložení ovládacích prvků a jejich oživení v C#
ConnectedServices - třeba DB, služby
Properties AndroidManifest.xml. Verze API (minimální a cílová), Ikona, vyžadovaná práva, a vlastně všechny parametry naší aplikace
Resources - obrázky dle velikosti zařízení, tabbar.xml, toolbar.xml,
MainActivity.cs - První aktivita po spuštění
-Zivotní cyklus. Aktivity - každá jednotlivá stránka má svoji aktivitu. Povinné je OnCreate() metoda. Neboli aplikace o třech stránkách má 3 aktivity.
OnCreate OnStart OnResume ---- Aktivita Běží ---- OnPause , OnStop , OnDestroy (z OnStop přes OnRestart() na OnStart())
Existuj 4 stavy aplikace Běží (spustila se a je na popředí), Pauza (běží ale není na popředí-je vidět, ale nedá se k ní dostat), Zastavená (není vidět ani se k ní nedá dostat), ale dá se obnovit. Ukončená - aktivita je mrtvá

Přechod mezi jednotlivými stavy

OnCreate() - když "někdo" spustá aplikaci. Načte obrázky, komponenty, umístí se na fullscreen
OnStart() - po OnCreate nebo OnRestart - nelze je uživatelsky vyvolat.
OnResume() - Těsně před tím než je posunuta do popředí. (Create, restart, Restart) Řekl bych než dostane focus
OnPause() - Těsně před odchodema na pozadí (volá systém)
OnStop() - Před zastavením aktivity (zmizí z uživatelského dosahu)
OnDestroy() - Před zrušením aktivity - úklid nebo zaznamenání stavu do dalšího spuštění (alternativně spuštění aktivity na pozadí)
OnRestart() - Když nás někdo oživí po STOP. Třeba když vyberu úlohu ze seznamu úloh na pozadí

Jazyk XAML v Xamarin.Forms

Pracuje se s (kořenový element) a v něm zpravidla což je kontejner na ovládací prvky, které se skládají za sebe.
Jmenné prostory - Name Space (xmlns) xmlns:x kde x udává alias - zde třeba x:Class udává ns třídy, která obsluhuje tuto MainPage.

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:d="http://xamarin.com/schemas/2014/forms/design"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
             mc:Ignorable="d"
             x:Class="MyFirstApp.MainPage">

xmlns:local="clr-namespace:MyFirstApp;assembly=MyFirstApp" local je tedy nyní cesta ke knihovně (assembly) a v ní jmenného prostoru (Name Space). Oboje je vlastně náš projekt. Ale když použiješ třeba binding tak ns bude jiný.

Lekce 4 - První multiplatformní aplikace v Xamarin a C# .NET

Testovací aplikace DialogApp. Postup vytvoření
Do Main page zapíšeš svoje oslovení a po stisku buttonu se ti přes DiaplayAlert zobrazí tvoje oslovení.

Lekce 5 - Pozicování v Xamarin.Forms

Absolutní pozicování - AbsoluteLayout. Ale moc se nepoužívá, takže si lze pomoci přes Grid,StackLayout, tím že jim nastavíme okraj Margin,89,23,0,0. Každé zařízení má jiný display, a ten si ještě uživatel múže změnit velikost zobrazování - je to strašně složitý vyhovět všem.
Relativní pozice - pozice je relativní vůči kontejneru v kterém je umístěná (center, start, end, fill) - nepoužívá se left right
Okraje - Margin/Padding Vnější/vnitřní, pořadí: levý okraj, horní, pravý, dolní nebo dvě cifry vodorovné/svislé, nebo jedna cifra = pro vše.
Jednotky velikostí. Pro Android dps (density-independent pixels), pro iOS pts (points). cca 163 pts = 160 dps = 1palec = 2,54cm neboli cca 63dps=1cm
Pozicování. HorizontalOptions/VerticalOptions.
Výška a šířka elementů. WidthRequest/HeightRequest. Nelze kombinovat s Fill nebo FillAndExpand protože ty automaticky vyplňují všechen volný prostor. Zde máme k dispozici Minimum/Maximum Height/Width Request
Pro praktické užití - Grid + StackLayout

Lekce 6 - Debug Xamarin aplikace na Android zařízení a stylovaní

Jak nastavit možnosti pro vývojáře na Mobilu. Nastavení/Systém/O telefonu/ 7xklik na Číslo sestavení. Pak se zobrazí Nastavení/Systém/Možnosti pro vývojáře.
DialogApp.sln. Musíš Update Nuget pro knihovny Xamarin.Forms a Xamarin.Assential. + Protože to chce Xamarin.Forms 10, tak ještě je třeba doNugetovat Xamarin.XEssential.Palette
Aplikace běží, po zadání jména i pozdraví- Label,Entry,Button,Image (AspectFill)

Lekce 7 - Uložení a načtení dat v Xamarin pomocí textového souboru

Vytvoř prázdný projekt Xamarin.Forms
V Adresáři Models vytvoř class ToDo.cs (Text,Date,IsDone). Implementuj rozhraní INotifyPropertyChanged kvůli bindingu. Neboli při změně textu zavolej v nabindované třídě (třídách) metodu PropertyChanged. Pokud se na model díváme ze stránky říkáme ji Context nebo BindingContext. INotifyPropertyChanged obsahuje pouze metodu PropertyChanged.
ToDosService.cs je třída, která se stará o seznam úkolů (Add,Remove) ve třídě ObservableCollection (chytřejší List pro Binding). Zároveň se stará o uložení a načtení do/z souboru XML.
O navigaci se stará NavigationPage (Místo MainPage). Pracuje na základě zásobníku. Je to jeden ze způsobů jak vůbec nepotřebuješ menu - zde stačí ToolBar a await Navigation.PushAsync(PageX) a await Navigation.PopAsync();. Pop voláš ze stránky ToDoItem, když dokončíš Add/Remov. Push když do této stránky skáčeš (z + nebo z Item).
NavigationPage obsahuje NavigationStack a na hlavní stránku se le dostat přes PopToRootAsync. Víc toho snad ani neumí, ale ani není co potřeba. Volá se z App.xaml.cs
ToDoDetailPage.xaml - Dynamický Binding na ToDo - aktivní prvek/prázdný prvek. Obsahuje Grid se dvěma Buttony a možnost měnit Text (via Binding)
ToDoListPage.xaml je vlastně MainPage. App.xaml nejprve vytvoří instanci ToDoService a pak tuto instanci předá ToDoListPage.xaml s tím že ji zároveň rozšíří jako NavigationPage.
ToDoListPage obsahuje ToolBar s jedním prvkem + a ListView se seznamem úkolů. Pokud dáš + nebi click na úkol volá ToDoDetailPage s Bindingem na prázdný nebo zobrazený ToDo. Volání se provádí přes navigaci Push().
Na začátku se načte soubor todos.xml a v průběhu se všechny změny aplikují do třídy ToDos (ObservableColections) a zároveň se zapisují. Neboli se čte 1x a zapisuje s Nx. Adresář "/data/user/0/com.companyname.todoapp/files/.local/share/todos.xml"

Lekce 9 - Použití SQLite databáze v Xamarin.Forms a C# .NET

Projekt jsem vytvořil z prázdné template. Používám SQLite DB v souboru todos.db. I když jsem vytvářel vše z prázdného projektu dělal jsem vlastně jen CopyPaste z minulého příkladu a úpravy
EntityFrameworkCore.Sqlite z Nuget
Model ToDo.cs - přidáme ID a řekneme [KEY] a Identity
ToDoService.cs - dědí z DbContext a Model je implementován jako DbSet<ToDo>. Konstruktor pak volá Database.EnsureCreated(); Database.Migrate(); což stačí pro vytvoření databáze a prvotní migraci.
. Všechny metody Get/Save/Remove jsou asynchronní a pro Save bez parametru se jen zapíšou změny (pro změnu isDone).
Přepíšeme metodu DbContext:OnConfiguration() - předáme Connection string na soubor databáze.
App.cs - skoro stejné jen se mění název souboru. (a nemusíme nic číst ze souboru)
ToDoListPage.xaml.cs OnAppearing je přepsaná metoda, která se volá vždy při zjevení stránky. Zde načtem věty do listView.ItemsSource --- takže tuto bindovací větu v xaml zrušíme ItemsSource="{Binding ToDos}"
ToDoDetailPage.xaml. Je změna na nové metody pro Save/Remove

Lekce 10 - Aplikace na počasí v Xamarin - GUI a základní třídy

openweathermap.org petrik@karia.cz/matonka123
https://api.openweathermap.org/data/2.5/weather?lat=50.0145&lon=14.6999&units=metric&appid=c5878bb26fdc489bdde624c7c0075528

Pro získání polohy telefonu (longitude/latitude) se používá Xamarin.Essential a jeho metody Geolocation.
Pro získání údajů o počasí je vytvořena třída WeatherInfoProvider, která přes HttpClient získá JSON o počasí. Tento JSON rozparsuje do třídy WeatherInfo a vrátí. Ikonu podá jako string což je název ikony z db ikon v openweathermap
Veškerou logiku najdeš v MainPage.xaml. Volám (onAppearing) RefreshWeatherData kde zjistím svoji pozici a načtu data o počasí (z WeatherInfoProvider). NAčtení vlastně vyklíruje obrazovku, zjistí zdali je konektivita (internet), doptá se na počasí a zkontroluje vrácené údaje. Vrácené info o počasí uloží do proměnných (preferences) a zobrazí nové hodnoty. Pokud není konektivita zobrazí data z preferences - pokud jsou časově platná.
Já jsem ještě doplnil timer v MainPage, který aktualizuje 1x za minutu, + lačítko pro aktualizaci, zobrazení longitude/latitude a název meteostanice.
Navíc jsem ještě doplnil timer do hlavního threadu (MainActivity), ale ten nejde v MainPage použít, protože to skončí na chybě typu "to není můj thread".

Lekce 15 - Navigace v Xamarin.Forms a C# .NET

Navigation Page. Umí procházet stránky formou zásobníku. Na každé stránce je vlastnost Navigation. Metody PushAsync(), PopAsync(), PopToRoorAsync(). Existuje zásobník stránek (NavigationStack).
Každá NavigationPage vypvoří nad stránkou AppBar (ToolBar). Zde lze provést Zpět, zobrazuje se Title, a ToolBarItem - neboli kam dál. AppBar lze skrýt, měnit barvu apod.
Další formy jsou MasterDetailPage (postranní menu tzv. flyout), TabbedPage - pomocí záložek, CarouselPage - swipování do stran.
Všechno je zajímavý ale - pro Windows Forms preferujeme Shell. Všechny výše zmíněné jsou rozplizlé, ale Shell definuje hierarchii navigace na jednom místě.
Shell stránka je podobná ContentPage, jen se jmenuje Shell a dědí od Shell a zpravidla se nastavuje jako hlavní stránka.
Shell má tři možnosti navigace Flyout, TabBar a navigace založená na URI cestách
TabBar umožňuje navigaci pomocí záložek na spodní straně obrazovky. Pokud se nevejdou udělá tři tečky a zobrazí menu na další
Flyout je vidět na příkladu - zobrazuje menu vlevo nahoře a pruh tabů pod ním. Implicitně je posuvný - když se nevejdou.

Lekce 16 - MVVM a rozhraní ICommand v Xamarin.Forms a C# .NET

ViewModel je speciální případ modelu určený pro pohled, tj. stránku. Drží data pro formulář, a zárove%n umí obsluhovat události stránky (ICommand)
ViewModel se uplatní tam, kde data přesně nenavazují na modely (např. u Filter). Data ve ViewModelu jsou nabindovaná na Form (via BindingContext), takže třeba Entry se mění automaticky. (INotifyPropertyChanged)
ICommand nám umožňuje nabindovat z ViewModelu metodu pro obsluhu akce ze stránky (ButtonClick).
ICommand má dvě metody Execute() a CanExecute().

ADB Tool (Android Debug Bridge)

Původně jsem se chtěl podívat na soubor todos.xml. Ale v emulátoru ani v mobilu jsem ho nenašel. Až jsem našel EDB.

Musíš mít nainstalované Android SDK Platform-Tools z Adroid SDK Manager. c:\Program Files (x86)\Android\android-sdk\platform-tools\ a tam ADB.EXE
Problém je root, abys mohl kopírovat soubory z LocalApplicationData. To nemám (zatím) a tak jsem si naistaloval další Emulátor, který nemá Google Play - ty prej jsou narootovaný.
adb root - příkaz nastaví root pro dané zařízení
adb pull /data/user/0/com.companyname.todoapp/files/.local/share/todos.xml c:/dummy/ --- zkopíruje z localApplicationData
Další příakaz adb shell. a pak můžeš ls -all
Zde najdeš Spousta dalších příkazů pro adb

Poznámky

Emulátor je v users\petri\.android\avd (Android Debug Bridge)
$"filePath={filePath}" to filePath ve složených závorkách je lib. parametr dtto jako +, ale ten parametr jde v ToString, takže třeba pro čísla OK.
Mám příliš dlouhou PATH (více jak 256 znaků). I když ve Windows ji povolenou mám, tak pro android je třeba si projekt odložit někam stranou. (Samozřejmě pokud si projekt nahraju blíže ke kořenu tak funguje) <IntermediateOutputPath>C:\Dummy\Xamarin</IntermediateOutputPath> <UseShortFileNames>True</UseShortFileNames>
chceš-li prohlížet sqlite databazi, staci sqliteonline.com. (Je také přímo integrace do VisualStudio, ale tu jsem nepoužil)
emulator -timezone Europe/Stockholm. V nastavení (táhni zhora, drž, kolečkem dolu a pak klikni na ozubený kolo. Úplne dole - System, time)
Publikování přes APK. Nejprve je třeba vytvořit APK file přes Clean/Build (pouze Release verzi). Pak si soubor zkopíruješ (com.companyname.todorest-Signed.apk v adresáři /Droid/Bin) do telefonu - kamkoliv ideálně do download a spustíš. A už se instaluje. (25.05.2021)

Diskuze o Xamarin

Background

V této diskuzi jsou dva odkazy jak vytvořit Foreground Service
V té druhé je diskuze o tom zdali používat pooling (jednou za čas vybrat back-end, abychom získali zprávy), nebo použít technologii Push notification. Problém s foreground service je u iOS
Jisté je, že App udrří při životě jen Foreground service (přehrávání písniček, navigace), ale je otázka zdali nelze pouřít nějaký méně náročný systém (background service??? )