{"id":58098,"date":"2023-04-22T12:07:12","date_gmt":"2023-04-22T10:07:12","guid":{"rendered":"https:\/\/ar3dp.de\/docs\/programmieren\/net-maui-basis-applikation-app-template\/erste-schritte\/"},"modified":"2023-04-22T12:07:12","modified_gmt":"2023-04-22T10:07:12","slug":"erste-schritte","status":"publish","type":"docs","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/net-maui-basis-applikation-app-template\/erste-schritte\/","title":{"rendered":"Getting started"},"content":{"rendered":"

User secrets<\/h3>\n\n\n\n

The app template works with user secrets. This is a recommended method to avoid finding passwords, licenses and API keys directly in the source code. For this purpose, a JSON file is stored on the PC, which contains all the necessary keys. This file is then read into the source code and the keys are loaded.<\/p>\n\n\n\n

Format of the secrets.json file<\/h4>\n\n\n\n

The format must look like this:<\/p>\n\n\n\n

{\n  "AppBasement": {\n    "SyncfusionApiKey": "your_key",\n    "AppCenterKeyiOS": "your_key",\n    "AppCenterKeyAndroid": "your_key",\n    "FirebaseUri": "https:\/\/xxx.firebaseio.com",\n    "FirebaseSecret": "",\n    "FirebaseApiKey": "your_key",\n    "FirebaseAuthDomain": "xxxx.firebaseapp.com",\n    "LicenseManagerProductCode": "xxxx"\n  }\n}<\/pre><\/div>\n\n\n\n
Beim ersten Start mit Visual Studio 2022 oder neuer, muss diese Datei erstellt werden. W\u00e4hle dazu im Projektmappen-Explorer mit der rechten Maustaste “Benutzergeheimisse verwalten” an. Dies \u00f6ffnet die secrets.json-Datei.<\/p>\n\n\n
\n
\"Manage<\/figure>\n<\/div>\n\n\n
Then copy the template from above into the file and swap the placeholder keys with your own.<\/p>\n\n\n\n
Syncfusion<\/h3>\n\n\n\n
In order to be able to use the full potential of the app template, a separate license from Syncfusion is required. A free community license can be requested for small businesses and individuals.<\/p>\n\n\n\n
Apply for a community license<\/div><\/a><\/div>\n\n\n\n
<\/p>\n\n\n\n
As soon as you have access, you can create a license key and enter it in the secrets.json.<\/p>\n\n\n\n
AppCenter<\/h3>\n\n\n\n
The app or our EventManager also works with AppCenter and can log events in AppCenter. It is recommended that you also manage your app project in AppCenter and enter your keys there.<\/p>\n\n\n\n
App Center<\/div><\/a><\/div>\n\n\n\n
Funktionen aktivieren bzw. deaktivieren<\/h3>\n\n\n\n
Das App-Template bietet einige Funktionen, welche nicht in jeder App ben\u00f6tigt werden. Diese sind standardm\u00e4\u00dfig deaktiviert und k\u00f6nnen in der Projektdatei aktiviert werden.<\/p>\n\n\n\n
\t\t<!-- Enables optional parts of the app template-->\n\t\t<DefineConstants>$(DefineConstants);Firebase;FirebaseAuth<\/DefineConstants>\n\t\t<DefineConstants>$(DefineConstants);License<\/DefineConstants>\n\t\t<DefineConstants>$(DefineConstants);AppCenter<\/DefineConstants><\/pre><\/div>\n\n\n\n
Dazu m\u00fcssen die jeweiligen Konstanten einfach aus dem Kommentartag <!-- --><\/code> herausgenommen werden. Gewissen Funktionen ben\u00f6tigen zus\u00e4tzliche Nugets bzw. weitere Anpassungen. Mehr dazu findest du unter den jeweiligen Funktionspunkten, welche folgen.<\/p>\n\n\n\n
AppCenter<\/h4>\n\n\n\n
F\u00fcr die AppCenter-Integration nutzen wir folgende Nugets, welche hinzugef\u00fcgt werden m\u00fcssen, sobald du die AppCenter-Funktionen nutzen m\u00f6chtest.<\/p>\n\n\n\n
\t  <!-- Needed for AppCenter -->\n\t  <PackageReference Include="Microsoft.AppCenter" Version="5.0.3" \/>\n\t  <PackageReference Include="Microsoft.AppCenter.Analytics" Version="5.0.3" \/>\n\t  <PackageReference Include="Microsoft.AppCenter.Crashes" Version="5.0.3" \/><\/pre><\/div>\n\n\n\n
Des Weiteren, vergewissere dich, dass du die n\u00f6tigen Schl\u00fcssel in der secrets.json<\/code>-Datei setzt!<\/p>\n\n\n\n
Firebase<\/h4>\n\n\n\n
F\u00fcr die Firebase-Integration nutzen wir folgende Nugets, welche hinzugef\u00fcgt werden m\u00fcssen, sobald du die Firebase-Funktionen nutzen m\u00f6chtest.<\/p>\n\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
AppShell<\/h5>\n\n\n\n
Entferne den Firebase<\/code> Kommentar in der AppShell<\/code> um den Men\u00fcpunkt zu aktivieren, welcher den Account verwaltet.<\/p>\n\n\n\n
<!-- Firebase -->\n<MenuItem \n    Text="{x:Static localization:Strings.Account}" \n    Command="{Binding ShowFirebaseAccountCommand}"\n    >\n    <MenuItem.IconImageSource>\n        <FontImageSource\n            FontFamily="{StaticResource FontIcons}"\n            Glyph="{x:Static iconsSyncfusion:SyncfusionIcons.Account}"\n            Color="{DynamicResource PrimaryColor}"\n            Size="Large"\n            >\n        <\/FontImageSource>\n    <\/MenuItem.IconImageSource>\n<\/MenuItem>\n<\/pre><\/div>\n\n\n\n
Des Weiteren, vergewissere dich, dass du die n\u00f6tigen Schl\u00fcssel in der secrets.json<\/code>-Datei setzt!<\/p>\n\n\n\n
License<\/h4>\n\n\n\n
F\u00fcr die Lizenz-Integration nutzen wir folgendes Nuget, welche hinzugef\u00fcgt werden muss, sobald du die Lizenz-Funktionen nutzen m\u00f6chtest.<\/p>\n\n\n\n
\t  <!-- Needed for licensing -->\n\t  <PackageReference Include="SharedMauiCoreLibrary.Licensing" Version="1.1.1" \/><\/pre><\/div>\n\n\n\n
AppShell<\/h5>\n\n\n\n
Entferne den License<\/code> Kommentar in der AppShell<\/code> um den Men\u00fcpunkt zu aktivieren, welcher die Lizenz verwaltet.<\/p>\n\n\n\n
    <!-- License -->\n    <MenuItem \n        Text="{x:Static localization:Strings.License}" \n        Command="{Binding ShowLicenseDetailsPageCommand}"\n        >\n        <MenuItem.IconImageSource>\n            <FontImageSource\n                FontFamily="{StaticResource MaterialDesignIcons}"\n                Glyph="{x:Static icons:MaterialIcons.AccountKeyOutline}"\n                Color="{DynamicResource PrimaryColor}"\n                Size="Large"\n                >\n            <\/FontImageSource>\n        <\/MenuItem.IconImageSource>\n    <\/MenuItem>\n   <\/pre><\/div>\n\n\n\n
Des Weiteren, vergewissere dich, dass du die n\u00f6tigen Schl\u00fcssel in der secrets.json<\/code>-Datei setzt!<\/p>","protected":false},"excerpt":{"rendered":"
Benutzergeheimnisse Das App-Template arbeitet mit Benutzergeheimissen (User Secrets). Dies ist eine empfohlene Methode um zu vermeiden, dass Passw\u00f6rter, Lizenzen und API-Schl\u00fcssel direkt im Quell-Code auffindbar sind. Dazu wird eine JSON-Datei auf dem PC abgelegt, welche alle n\u00f6tigen Schl\u00fcssel enth\u00e4lt. Im Quellcode wird dann diese Datei eingelesen und die Schl\u00fcssel geladen. Format der secrets.json-Datei Das Format…<\/p>","protected":false},"author":1,"featured_media":0,"parent":57992,"menu_order":1,"comment_status":"open","ping_status":"closed","template":"","meta":{"_featured":false,"_is_vendor_doc":"0","footnotes":""},"doc_tag":[],"class_list":["post-58098","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58098","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=58098"}],"version-history":[{"count":3,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58098\/revisions"}],"predecessor-version":[{"id":58742,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58098\/revisions\/58742"}],"up":[{"embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/57992"}],"next":[{"title":"Hosting & AppBuilder","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/net-maui-basis-applikation-app-template\/hosting-appbuilder\/","href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/58146"}],"prev":[{"title":"Introducing .NET MAUI AppTemplate","link":"https:\/\/ar3dp.de\/en\/docs\/programmieren\/net-maui-basis-applikation-app-template\/vorstellung-net-maui-apptemplate\/","href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/docs\/57993"}],"wp:attachment":[{"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/media?parent=58098"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ar3dp.de\/en\/wp-json\/wp\/v2\/doc_tag?post=58098"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}