{"id":58257,"date":"2023-07-22T09:55:20","date_gmt":"2023-07-22T07:55:20","guid":{"rendered":"https:\/\/ar3dp.de\/docs\/programmieren\/net-maui-basis-applikation-app-template\/firebase\/"},"modified":"2023-07-22T09:55:20","modified_gmt":"2023-07-22T07:55:20","slug":"firebase","status":"publish","type":"docs","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/net-maui-basis-applikation-app-template\/firebase\/","title":{"rendered":"Firebase"},"content":{"rendered":"\n

Firebase Synchronisierung<\/h2>\n\n\n\n

Unser App-Template ist vorbereitet, Nutzerdaten, sowie Standard-Konfigurationen aus Firebase zu laden und zu synchronisieren. Dies erlaubt es, Nutzerdaten \u00fcber verschiedene Ger\u00e4te synchron zu halten. Um den Service zu aktivieren, definiere folgende Konstanten in der AppBasement.csproj<\/code> Datei und f\u00fcge folgende Nuget-Pakete hinzu.<\/p>\n\n\n\n

\t<!-- Enables all firebase code -->\n\t<DefineConstants>$(DefineConstants);Firebase;FirebaseAuth<\/DefineConstants>\n\n\n\t<!-- Needed for Firebase -->\n\t<PackageReference Include="FirebaseAuthentication.net" Version="4.1.0" \/>\n\t<PackageReference Include="FirebaseDatabase.net" Version="4.2.0" \/><\/pre><\/div>\n\n\n\n
Firebase einrichten<\/h3>\n\n\n\n
Falls nicht vorhanden, ben\u00f6tigest du einen Account bei Firebase. Dieser ist kostenlos und kann mit einem Google-Konto ganz einfach erstellt werden. Besuche dazu einfach folgenden Link:<\/p>\n\n\n\n
Firebase Console:<\/strong> https:\/\/console.firebase.google.com\/u\/1\/<\/a><\/p>\n\n\n\n
Anschlie\u00dfend erstelle ein neues Projekt<\/strong>, indem du auf “Projekt hinzuf\u00fcgen” klickst.<\/p>\n\n\n
\n
\"Neues
Neues Projekt erstellen<\/figcaption><\/figure>\n<\/div>\n\n\n
Folge anschlie\u00dfend den Setup-Assistenten.<\/p>\n\n\n\n
\n
\n
\"Benenne
Benenne dein Projekt<\/figcaption><\/figure>\n<\/div><\/div>\n\n\n\n
\n
\"Konfiguriere
Konfiguriere Google Analytics, falls gew\u00fcnscht<\/figcaption><\/figure>\n<\/div><\/div>\n<\/div>\n\n\n\n
Nach dem das Projekt erstellt wurde, f\u00fcge die Dienste “Echtzeitdatenbank” und “Authentifizierung” zu deinem Projekt hinzu.<\/p>\n\n\n
\n
\"Erstellen
Erstellen der ben\u00f6tigten Dienste<\/figcaption><\/figure>\n<\/div>\n\n\n
Firebase Authentifizierung<\/h3>\n\n\n\n
Um die Authentifizierung nutzen zu k\u00f6nnen, solltest du mindestens die Registrierung per Mail und Passwort aktivieren. Dies ist auch die Standard-Loginmethode f\u00fcr das App Template. Alle weiteren Dienste sind aktuell noch nicht umgesetzt.<\/p>\n\n\n
\n
\"Anmeldemethoden
Anmeldemethoden verwalten und erstellen<\/figcaption><\/figure>\n<\/div>\n\n\n
Firebase Realtime Database<\/h3>\n\n\n\n
Zum Speichern der Daten ist eine Datenbank erforderlich. Diese kannst du ebenfalls mit ein paar Klicks erstellen. Klicke dazu unter “Entwickeln” auf “Realtime Database” und anschlie\u00dfend auf “Datenbank erstellen”. Folge den Schritten bis zum Abschluss.<\/p>\n\n\n\n
\n
\n
\"Speicherort
Speicherort der Datenbank ausw\u00e4hlen (USA ist empfohlen)<\/figcaption><\/figure>\n<\/div><\/div>\n\n\n\n
\n
\"Einrichten
Einrichten der Sicherheitsregel (hier im Testmodus starten)<\/figcaption><\/figure>\n<\/div><\/div>\n<\/div>\n\n\n\n
Anschlie\u00dfend m\u00fcssen die Sicherheitsregeln \u00fcberarbeitet werden. Aktuell hat jeder Zugriff auf alle Daten. Du kannst folgende Sicherheitsregel als Grundlage verwenden.<\/p>\n\n\n\n
{\n "rules": {\n   \/* Access for custom folders (preset data for instance)\n   "Printers":{\n     ".read": "auth != null",\n     ".write": false,\n   },\n   *\/\n   "users": {\n      "$uid": {\n        ".write": "$uid === auth.uid",\n        ".read": "$uid === auth.uid",\n      }\n   }\n \t}\n}<\/pre><\/div>\n\n\n\n
Hier ist es allen erlaubt zu lesen, welche sich Authentifiziert haben (\u00fcber API-Schl\u00fcssel oder Anmeldung). Des Weiteren k\u00f6nnen Benutzer (“users”) unter dem Datenbankpfad “users”, dort wo die Benutzerdaten abgelegt werden, nur unter Ihrer ID Schreiben und Lesen.<\/p>\n\n\n\n
App konfigurieren<\/h3>\n\n\n\n
Abschlie\u00dfend muss die App konfiguriert werden, dass diese mit dem Firebase Projekt interagieren kann. Dazu musst du erst eine “Web App” in Firebase erstellen. Klicke dazu auf das “<\/>” Symbol.<\/p>\n\n\n
\n
\"Neue
Neue Web-App erstellen<\/figcaption><\/figure>\n<\/div>\n\n\n
Anschlie\u00dfend gib deiner App noch einen passenden Namen und best\u00e4tige das Setup mit “App registrieren”.<\/p>\n\n\n
\n
\"Neue
Neue Web App registrieren<\/figcaption><\/figure>\n<\/div>\n\n\n
Nun erh\u00e4ltst du alle n\u00f6tigen Zugangsdaten, welche unser App-Template ben\u00f6tigt, um mit deinem Firebase Projekt zu interagieren. Die Daten sehen wie folgt aus:<\/p>\n\n\n\n
const firebaseConfig = {\n  apiKey: "xxxxx_your_api_key",\n  authDomain: "your_project.firebaseapp.com",\n  databaseURL: "https:\/\/your_project-rtdb.firebaseio.com",\n  projectId: "your_project",\n  storageBucket: "your_project.appspot.com",\n  messagingSenderId: "XXX",\n  appId: "1:XXXXX",\n  measurementId: "G-XXXXXXX"\n};<\/pre><\/div>\n\n\n\n
Diese Informationen m\u00fcssen nun in der secrets.json<\/code> Datei eingegeben werden.<\/p>\n\n\n\n
{\n  "AppBasement": {\n    \/\/...\n    "FirebaseUri": "https:\/\/your_project-rtdb.firebaseio.com",\t\t\t\/\/ The databaseURL\n    "FirebaseSecret": "xxxxx_your_secret_key",\t\t\t\t\t\t\t\/\/ The secret (obsolete)\n    "FirebaseApiKey": "xxxxx_your_api_key",\t\t\t\t\t\t\t\t\/\/ The apiKey\n    "FirebaseAuthDomain": "your_project.firebaseapp.com",\t\t\t\t\/\/ the authDomain\n    \/\/...\n  }\n}<\/pre><\/div>\n\n\n\n
Der DatabaseSecret<\/code> ist abgek\u00fcndigt und sollte nicht mehr verwendet werden. Stattessen sollte die Authentifizierung \u00fcber eine Anmeldung bzw. den API-Schl\u00fcssel erfolgen. Nichtsdestotrotz findest du das Secret<\/code> unter “Projekteinstellungen -> Dienstkonto -> Datenbank-Secrets”.<\/p>\n\n\n\n
Mehr zu der secrets.json<\/code> Datei findest du in den Ersten Schritten<\/a>.<\/p>\n\n\n\n
FirebaseHandler<\/h3>\n\n\n\n
Im App-Template \u00fcbernimmt die Helferklasse FirebaseHandler<\/code> den Datenaustausch, sowie die Authentifizierung mit Firebase. Im LoadingPageViewModel.Refresh()<\/code> wird, sofern sich schon ein Benutzer angemeldet hat, die Einstellungen synchronisiert. <\/p>\n\n\n\n
Func<Task> onSuccess = async () =>\n{\n  var settings = await FirebaseHandler.Instance.GetAppSettingsDictionaryAsync();\n  await SettingsApp.LoadSettingsAsync(dictionary: settings);\n};\nif (!string.IsNullOrEmpty(SettingsApp.Firebase_Username) && !string.IsNullOrEmpty(SettingsApp.Firebase_Password))\n{\n  await LoginFirebaseWithCredentialsAsync(SettingsApp.Firebase_Username, SettingsApp.Firebase_Password, onSuccess: onSuccess);\n}\nelse\n{\n  \/\/ If no account infos are available, login as anonymous (If allowed by your Firebase setup)\n  \/\/await LoginFirebaseAnonymouslyAsync(onSuccess: onSuccess);\n}<\/pre><\/div>\n\n\n\n
Werden w\u00e4hrend der Laufzeit Einstellungen angepasst, so werde diese gleich Richtung Firebase synchronisiert.<\/p>\n\n\n\n
[ObservableProperty]\nbool allowAppTracking = false;\npartial void OnAllowAppTrackingChanged(bool value)\n{\n  if (!IsLoading)\n  {\n    SettingsApp.Privacy_AllowAppTracking = value;\n    SettingsApp.SettingsChanged = true;\n    #if FirebaseAuth\n      FirebaseHandler.Instance.SyncSettings(setting => SettingsApp.Privacy_AllowPersonalizedAds);\n    #endif\n    }\n  if (AllowAppTracking && !IsLoading && SettingsStaticDefault.Privacy_AllowPersonalizedAds)\n  {\n    Task.Run(RequestTrackingAuthorization);\n  }\n}<\/pre><\/div>\n\n\n\n
Durch das \u00c4ndern der Einstellungen in der “Firebase Realtime Database”, wird automatisch ein Event<\/code> ausgel\u00f6st und alle aktiven Applikationen benachrichtig. Um auf das Event reagieren zu k\u00f6nnen, wird beim Anmelden eine Func<\/code> mitgegeben, welche die ge\u00e4nderten Einstellungen lokal aktualisiert.<\/p>\n\n\n\n
userInfo = await FirebaseHandler.Instance.LoginWithEmailAndPasswordAsyncAsync(username, password, onDataChanged: async (p) =>\n{\n    \/\/ Save the users settings on any changes\n    await SettingsApp.LoadSettingsAsync(p.Item1, p.Item2);\n});\n\n\/\/....\n\nOnUserDataChangedEvent(new()\n{\n    User = CurrentUser,\n    SettingsKey = p.Item1,\n    ChangedSetting = data,\n});<\/pre><\/div>\n\n\n\n
Die gew\u00e4hrleistet, dass bei Mehrfachnutzung der Applikation, die Daten nicht auseinander laufen und eine Instanz die Daten der zweiten Instanz \u00fcberschreibt.<\/p>\n","protected":false},"excerpt":{"rendered":"
Firebase Synchronisierung Unser App-Template ist vorbereitet, Nutzerdaten, sowie Standard-Konfigurationen aus Firebase zu laden und zu synchronisieren. Dies erlaubt es, Nutzerdaten \u00fcber verschiedene Ger\u00e4te synchron zu halten. Um den Service zu aktivieren, definiere folgende Konstanten in der AppBasement.csproj Datei und f\u00fcge folgende Nuget-Pakete hinzu. Firebase einrichten Falls nicht vorhanden, ben\u00f6tigest du einen Account bei Firebase. Dieser…<\/p>","protected":false},"author":1,"featured_media":0,"parent":57992,"menu_order":9,"comment_status":"open","ping_status":"closed","template":"","meta":{"_featured":false,"_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-58257","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58257","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/comments?post=58257"}],"version-history":[{"count":1,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58257\/revisions"}],"predecessor-version":[{"id":58687,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58257\/revisions\/58687"}],"up":[{"embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/57992"}],"next":[{"title":"License Manager","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/net-maui-basis-applikation-app-template\/lizenz-manager\/","href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58290"}],"prev":[{"title":"Dipatching & UIThread","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/net-maui-basis-applikation-app-template\/dipatching-uithread\/","href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58002"}],"wp:attachment":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/media?parent=58257"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/doc_tag?post=58257"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}