2. Konfiguration

Konfiguration

Zur Nachnutzung der App sind einige Anpassungen erforderlich.

Build-Konfiguration

Öffnen Sie das BibApp Projekt in Android Studio und duplizieren Sie links in der Project Ansicht die Datei signing.gradle.sample und nennen diese signing.gradle.

In dieser Datei finden Sie eine Vorlage zur Konfiguration der App-Variante für Ihre Bibliothek und zur Signierung der App.

Flavors

Jede BibApp wird doch ein Flavor differenziert. Ein Flavor lässt sich am einfachsten als Variante verstehen. Jede App ist in Ihrer Grundfunktionalität gleich, unterscheidet sich aber in Konfiguration, Übersetzung, Logos, etc.

Um eine Variante für Ihre Bibapp zu konfigurieren passen den entsprechenden Block wie folgt an.

productFlavors {
    yourbib {
        applicationId "de.org.yourbib"
        versionCode 1
        versionName "2.0.0"
        signingConfig signingConfigs.release
    }
}

• yourbib Die Bezeichnung für Ihre Variante, üblicherweise das Kürzel Ihrer Bibliothek
• applicationId Die ID Ihrer App, üblicherweise beginnend mit der umgedrehten Domain Ihrer Organisation
• versionCode Auf 1 belassen bei Neuveröffentlichung, bei Updates erhöhen
• versionName Versionsnummer der Bibapp

Signierung

Jede App, die in Google Play veröffentlicht werden soll, muss signiert werden. Nähere Informationen hierzu finden sich in der Entwicklerdokumentation von Android (Signing Your Applications).

App-Konfiguration

Öffnen Sie das Verzeichnis app/src im Projektverzeichnis und kopieren Sie eine der vorliegenden Varianten (z.B. das Verzeichnis il) und benennen Sie es entsprechend des oben konfigurierten Wertes.

Schnittstellen

In Quellverzeichnis Ihrer Variante befindet sich die Datei java/de.eww.bibapp.constants/Constants.java. Öffnen Sie diese und passen Sie die Konfiguration der Schnittstellen und Dienste entsprechend Ihrer Bedürfnisse an.

Name der App / Kontakt / Impressum / Übersetzungen

Unter res/values/ finden Sie eine Datei strings.xml. Hier können Sie die Übersetzung Ihrer App anpassen. Dies umfasst auch die Texte zu den Seiten Kontakt und Impressum. Zur Formatierung der Texte können Sie HTML-Tags verwenden. Außerdem lässt sich unter dem Schlüssel app_name der Name der App anpassen.

Sie haben auch die Möglichkeit weitere Übersetzungen entsprechend Ihrer Wünsche zu verändern. Öffnen Sie dazu die Datei app/src/main/res/values/strings.xml. Kopieren Sie die Übersetzungen, die Sie überschreiben möchten in Ihre eigene strings.xml und nehmen Sie entsprechende Änderungen vor.

Farben

In der Datei res/values/colors.xml können Sie die farbliche Gestaltung der App konfigurieren. Die meisten Bibliotheken verfügen bereits über einen Styling-Guide und einer Grundfarbe, die Sie hier wiederaufgreifen können.

Logos

Für die Erzeugung der Logos können Sie das Tool Android Asset Studio nutzen. Mit dem Launcher Icon Generator können Sie die erforderlichen Icons in allen Größen erzeugen. Kopieren Sie anschließend Ihre Icons mit dem Namen icon.png in die entsprechenden Verzeichnisse unter res/.

Google Maps (Optional)

Wenn Sie in Ihrer App für die zur Verfügung stehenden Standorte eine Standortanzeige über Google Maps einbinden möchten, gehen Sie wie folgt vor:

Erstellen Sie im Quellverzeichnis Ihrer Variante unter res/values eine Datei maps.xml mit dem nachfolgenden Inhalt.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="google_maps_v2_key">[IHR API SCHLÜSSEL]</string>
</resources>

Informationen für die Generierung eines Google Maps Keys für Android finden Sie im Google Maps Android API v2 Guide.

Weiter zu 3. Build