Was ist eine eigenständige mobile App?
In der Regel sind alle Simplifier Apps mobilfähig 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 “Standalone”-Distribution für Android und iOS/iPadOS Mobile Geräte erstellen.
Wann brauche ich “Standalone”?
- Wenn Sie Ihre App im Google Play Store oder Apple Store mit Ihrem Unternehmen als Herausgeber sowie mit Ihrem eigenen Logo und Namen veröffentlichen möchten
- Ihre Kunden sollten das App-in-App-Konzept / Simplifier Mobile App nicht nutzen
Nutzen Sie unseren Self-Service zur Erstellung und Bereitstellung eigenständiger Anwendungen
Ab MAKERS CHOICE 25-05/Simplifier 10 können Sie auch unseren Self-Service nutzen, um Ihre Standalone-Anwendungen zu erstellen und einzusetzen. Derzeit befindet sich die Funktion in der experimentellen Feature Lifecycle Phase. Wir sind dabei, sie auch in den App Designer in der Simplifier Admin UI zu integrieren. Wenn Sie Ihre Standalone-Anwendung erstellen möchten, erstellen Sie einfach ein Ticket in unserem Support-Portal. Wir leiten Sie durch den Prozess.
Voraussetzungen
Sie benötigen lediglich ein aktives Abonnement für unseren Standalone Application Service.
Erforderliche Daten
Damit der Dienst Ihre Anwendung erstellen und bereitstellen kann, sind die folgenden Daten erforderlich
- App-Ressourcen
- App log (quadratisch, mindestens 1024px+1024px)
- Verwendete mobile Funktionen
- Zertifikate und Keystore-Dateien für Ihre Google/Apple-Konten
Sobald Sie das Ticket aufgegeben haben, werden wir uns mit Ihnen in Verbindung setzen und alle Daten im Detail durchgehen.
Erstellen Sie Ihre Anwendungen manuell
Wenn Sie nicht mindestens unser MAKERS CHOICE 25-05 oder Simplifier 10 verwenden, müssen Sie Ihre Standalone-Anwendungen manuell erstellen
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üssel | Beispielwert | Weitere Informationen |
Server-URL | https://mysimplifier.mycompany.com | Die vollständige Webadresse (URI) des Simplifier Productive Server |
Bundle-ID | com.firmenname.meinAppName | Eine Bundle-ID, auch als Paket bezeichnet, ist die eindeutige Kennung für Ihre Simplifier-App. Sie muss eindeutig sein, denn wenn Sie sie in den App Store hochladen, wird Ihre App anhand des Paketnamens als eindeutige App-Kennung identifiziert und veröffentlicht. |
Bundle-Version | 1 | Geben Sie die Build-Versionsnummer der Anwendung ein, die eine Iteration (freigegeben oder nicht freigegeben) der Anwendung kennzeichnet. Die Version wird im üblichen Format einer Zeichenkette mit durch Punkte getrennten Zahlen angegeben (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/Bildschirme/<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
Prüfen Sie die XML-Parameter
android-targetSdkVersion
– Sie sollten mindestens die API-Version 30 oder höher wählen , siehe Versionsgeschichte
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" />
Setzen Sie diese Option auf true, wenn Sie nicht möchten, dass die Benutzeroberfläche ein Feedback anzeigt, wenn Benutzer über den Anfang oder das Ende des Inhalts hinaus scrollen. Unter iOS führen Overscroll-Gesten dazu, dass der Inhalt an seine ursprüngliche Position zurückspringt. Unter Android erzeugen sie einen subtileren Leuchteffekt entlang des oberen oder unteren Randes des Inhalts.
Weitere Informationen zu den Config Options 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
Um die Anwendung zu signieren, müssen Sie Ihr Zertifikat während des Erstellungsprozesses bereitstellen
Am einfachsten ist es, eine neue Datei build.json mit folgendem Inhalt zu erstellen
Hier ist ein Beispiel für eine Build-Konfigurationsdatei:
{ "android": { "release": { "keystore": "../android.keystore", "storePassword": "", "alias": "mykey2", "password" : "password", "keystoreType": "" } } }
Parameter | Flagge | Beschreibung |
---|---|---|
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
Build your App for iOS
For iOS you have to install xCode before – the build process can only run on MacOS
Step 1 Add iOS Platform
Go to console, switch to your workspace and enter
cordova platform add ios
After that, the xCode Project and iOS Ressource will be created
Step 2 – Add ios Build Config to build.json
Open or create the build.json in your workspace
{ "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\"" ] } } }
For more explanation see table below
Parameter | Flag | Description |
---|---|---|
Code Sign Identity | --codeSignIdentity |
Code signing identity to use for signing. It can be created with Xcode and added to your keychain. Starting with Xcode 8 you should use --codeSignIdentity="iPhone Developer" both for debug and release . |
Development Team | --developmentTeam |
The development team (Team ID) to use for code signing. You would use this setting and a simplified Code Sign Identity (i.e. just ‘iPhone Developer’) to sign your apps, you do not need to provide a Provisioning Profile. |
Packaging Type | --packageType |
This will determine what type of build is generated by Xcode. Valid options are development (the default), enterprise , ad-hoc , and app-store . |
Provisioning Profile | --provisioningProfile |
(Optional) GUID of the provisioning profile to be used for manual signing. It is copied here on your Mac: ~/Library/MobileDevice/Provisioning\ Profiles/ . Opening it in a text editor, you can find the UUID which needs to be specified here if using manual signing. |
Code Sign Resource Rules | --codesignResourceRules |
(Optional) Used to control which files in a bundle should be sealed by a code signature. For more details, read The OS X Code Signing In Depth article |
Automatic Provisioning | --automaticProvisioning |
(Optional) Enable to allow Xcode to automatically manage provisioning profiles. Valid options are false (the default) and true . |
Step 3 – Start the Build Process
Start the build process with
cordova build ios