Was ist eine eigenständige mobile App?
In der Regel sind alle Simplifier Apps mobil ready und können direkt mit dem Simplifier Mobile Client geöffnet werden.
Wenn Sie die Simplifier Mobile Client App nicht verwenden möchten, können Sie eine “eigenständige” Distribution für Android- und iOS-Mobilgeräte erstellen.
Wann brauche ich “Standalone”?
- Wenn Sie Ihre App im Google Play Store oder Apple Store mit Ihrem Unternehmen als Aussteller veröffentlichen möchten, sowie mit eigenem Logo und Namen
- Ihre Kunden sollten das App-in-App-Konzept / Simplifier Mobile App nicht nutzen
Voraussetzungen
Um eine mobile App als einzelnes Distributionspaket zu exportieren und zu erstellen, müssen Sie Ihren Client mit den erforderlichen Build-Tools vorbereiten: Software:
- Installiertes Cordova-Build-Tool (Installationshandbuch)
- Android Studio zum Erstellen von Android-Apps (Installationshandbuch)
- Apple xCode (Weitere Informationen)
Hardware:
- Windows- oder Linux-Client und/oder
- Mac für Apple xCode
Außerdem benötigen Sie eine
- Google-Entwicklerkonto
- Apple-Entwicklerkonto
Einrichten von Metadaten
Schlüsselbeispiel | Wert | Weitere Informationen |
Server-URL | https://mysimplifier.mycompany.com | Die vollständige Webadresse (URI) des Simplifier Productive Servers |
Paket-ID | com.companyname.myAppName | Eine Paket-ID, auch als Paket bezeichnet, ist die eindeutige Kennung für Ihre Simplifier-App. Sie muss eindeutig sein, da beim Hochladen in den App Store Ihre App mithilfe des Paketnamens als eindeutige App-Identifizierung identifiziert und veröffentlicht wird. |
Bundle Version | 1 | Geben Sie die Buildversionsnummer der App ein, die eine Iteration (freigegeben oder nicht veröffentlicht) der Anwendung angibt. Die Version wird im üblichen Format eines Strings angegeben, der Zahlen enthält, die durch Punkte getrennt sind (z. B. 4.3.2). |
Vorbereiten der Build-Umgebung
App-Quellen herunterladen
Der Download der App-Quellen wird hier beschrieben.
Überprüfen Sie Corodova
cordova --version
Es sollte Version 10 oder höher sein
Arbeitsbereich erstellen
Erstellen Sie ein neues Verzeichnis für Ihr App-Projekt “myworkpace”
Kopieren Sie Ihren Simplifier Mobile-Export in Workspace
Kopieren Sie die vollständigen Verzeichnisse und Dateien in den Arbeitsbereich
config.xml package.json hooks www
Erstellen einer Keystore-Datei für Android
Legen Sie es unter dem Ordner signing/android/release.keystore ab
Bildschirm und Symbole hinzufügen
res/icons/<Android/iOS> res/screens/<Android/iOS> und fügen Sie die Symbole und Bilder als Referenzpfad in Ihrem Download-config.xml hinzu
Überprüfen der vollständigen Buildkonfiguration
Öffnen Sie die Datei config.xml in einem XML-Editor wie Android Studio, Notepad++ oder Visual Studio Code. Überprüfen Sie den XML-Parameter.
android-targetSdkVersion
– Mindestens sollten Sie API-Version 30 oder höher auswählen, siehe Versionsverlauf und Autor
<authoremail="dev@cordova.apache.org"href="http://cordova.io"> Apache Cordova Team </author>
Für iOS-Builds werden die folgenden Einstellungen empfohlen
<preference name="DisallowOverscroll" value="true" />
: Legen Sie diese Einstellung auf “true ” fest, wenn Sie nicht möchten, dass auf der Benutzeroberfläche Feedback angezeigt wird, wenn Benutzer über den Anfang oder das Ende des Inhalts hinaus scrollen.
Unter iOS führen Überscroll-Gesten dazu, dass Inhalte an ihre ursprüngliche Position zurückgeprallt werden.
Unter Android erzeugen sie einen subtileren Leuchteffekt am oberen oder unteren Rand des Inhalts.
Weitere Informationen zu den Konfigurationsoptionen finden Sie in der offiziellen Dokumentation.
Bereinigen Sie Ihre Projekte (optional)
Wenn Sie bereits einen Build in Ihrem Arbeitsbereich erstellt haben, bereinigen Sie die Ergebnisse vorher:
rm -rf platforms rm -rf plugins rm -rf node_modules rm package-lock.json
Initialisieren der NPM-Module
HINWEIS: Nur für Simplifier <= v6.5 erforderlich! Um die neuesten Quellen zu aktualisieren, wechseln Sie in Ihr workpace-Verzeichnis und geben Sie
npm run init
Cordova-Plug-ins herunterladen
HINWEIS: Nur für Simplifier <= v6.5 erforderlich! Um Cordova-Plug-ins herunterzuladen, geben Sie
npm run fetch
Erstellen Sie Ihre App für Android
Wenn Sie Ihre Umgebung vorbereitet haben, können Sie den Buildprozess starten
Schritt 1 Android-Plattform hinzufügen
Hinzufügen der Android-Plattform zu Ihrem Build-Projekt
cordova platform add android
Nach diesem Schritt wurde ein neues Android-Projekt im Ordner platforms/android erstellt.
Schritt 2 Erstellen Sie build.json
Zum Signieren der App müssen Sie Ihr Zertifikat im Buildprozess bereitstellen. Am einfachsten ist es, eine neue Datei build.json mit folgendem Inhalt zu erstellen: Hier sehen Sie ein Beispiel für eine Buildkonfigurationsdatei:
{ "android": { "release": { "keystore": "../android.keystore", "storePassword": "", "alias": "mykey2", "password" : "password", "keystoreType": "" } } }
Beschreibung | Parameter-Flags | |
---|---|---|
Schlüsselspeicher | --keystore |
Pfad zu einer Binärdatei, die einen Satz von Schlüsseln enthalten kann |
Keystore-Passwort | --storePassword |
Passwort für den Keystore |
Alias | --alias |
Die ID, die den privaten Schlüssel angibt, der zum Signieren verwendet wird |
Passwort | --password |
Kennwort für den angegebenen privaten Schlüssel |
Typ des Keystores | --keystoreType |
Standard: Automatische Erkennung basierend auf der Dateierweiterung Entweder pkcs12 oder jks |
Schritt 3: Starten Sie den Android-Build
Eintreten
cordova build android
, um die App über Android Studio zu kompilieren.
Die apk wird unter
<yourworkspace>/platforms/android/app/build/outputs/apk
Erstellen Sie Ihre App für iOS
Für iOS müsst ihr vorher xCode installieren – der Build-Prozess kann nur unter MacOS laufen
Schritt 1 iOS-Plattform hinzufügen
Gehen Sie zur Konsole, wechseln Sie zu Ihrem Arbeitsbereich und geben Sie
cordova platform add ios
Danach werden das xCode-Projekt und die iOS-Ressource erstellt
Schritt 2 – Fügen Sie ios Build Config zu build.json hinzu
Öffnen oder erstellen Sie die build.json in Ihrem Arbeitsbereich
{ "ios": { "release": { "codeSignIdentity": "iPhone Developer", "developmentTeam": "FG35JLLMXX4A", "packageType": "app-store", "automaticProvisioning": true, "buildFlag": [ "EMBEDDED_CONTENT_CONTAINS_SWIFT = YES", "ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES=NO", "LD_RUNPATH_SEARCH_PATHS = \"@executable_path/Frameworks\"" ] } } }
Weitere Erläuterungen finden Sie in der folgenden Tabelle
Beschreibung | Parameter-Flags | |
---|---|---|
Identität des Codezeichens | --codeSignIdentity |
Codesignaturidentität, die zum Signieren verwendet werden soll. Es kann mit Xcode erstellt und zu Ihrem Schlüsselbund hinzugefügt werden. Ab Xcode 8 sollten --codeSignIdentity="iPhone Developer" Sie sowohl for debug release als auch verwenden. |
Entwicklungsteam | --developmentTeam |
Das Entwicklungsteam (Team-ID), das für die Codesignierung verwendet werden soll. Wenn Sie diese Einstellung und eine vereinfachte Code Sign-Identität (d. h. nur “iPhone Developer”) verwenden, um Ihre Apps zu signieren, müssen Sie kein Bereitstellungsprofil bereitstellen. |
Art der Verpackung | --packageType |
Dadurch wird bestimmt, welcher Buildtyp von Xcode generiert wird. Gültige Optionen sind development (Standard), enterprise , und ad-hoc app-store . |
Bereitstellungsprofil | --provisioningProfile |
(Fakultativ) GUID des Bereitstellungsprofils, das für die manuelle Signatur verwendet werden soll. Es wird hier auf Ihren Mac kopiert: ~/Library/MobileDevice/Provisioning\ Profiles/ .Wenn Sie es in einem Texteditor öffnen, finden Sie die UUID, die hier angegeben werden muss, wenn Sie die manuelle Signierung verwenden. |
Regeln für Codesignatur-Ressourcen | --codesignResourceRules |
(Fakultativ) Wird verwendet, um zu steuern, welche Dateien in einem Bundle durch eine Codesignatur versiegelt werden sollen. Weitere Informationen finden Sie im Artikel OS X Code Signing im Detail |
Automatische Bereitstellung | --automaticProvisioning |
(Fakultativ) Aktivieren Sie diese Option, damit Xcode Bereitstellungsprofile automatisch verwalten kann. Gültige Optionen sind false (Standard) und true . |
Schritt 3 – Starten des Build-Prozesses
Starten Sie den Build-Prozess mit
cordova build ios