Archived

This repository has been archived on 2023-11-19. You can view files and clone it, but cannot push or open issues or pull requests.

Morgan McMillian 892cb0e141 add native android build sources

2018-07-15 19:24:48 -07:00

5.8 KiB

Raw Blame History

cordova-plugin-splashscreen

Dieses Plugin zeigt und verbirgt einen Splash-Screen beim Start der Anwendung.

Installation

// npm hosted (new) id
cordova plugin add cordova-plugin-splashscreen
// you may also install directly from this repo
cordova plugin add https://github.com/apache/cordova-plugin-splashscreen.git

Unterstützte Plattformen

Amazon Fire OS
Android
BlackBerry 10
iOS
Windows Phone 7 und 8
Windows 8
Windows
Browser

Methoden

SplashScreen.Show
SplashScreen.Hide

Android Eigenarten

Sie müssen in Ihrem "config.xml"fügen Sie die folgenden Einstellungen:

<preference name="SplashScreen" value="foo" />
<preference name="SplashScreenDelay" value="10000" />
<preference name="SplashMaintainAspectRatio" value="true|false" />

Wo Foo ist der Name der Datei Splashscreen, vorzugsweise eine 9-Patch-Datei. Stellen Sie sicher, Splashcreen Dateien zu Ihrem res/xml-Verzeichnis unter den entsprechenden Ordnern hinzuzufügen. Der zweite Parameter stellt dar, wie lange das Splashscreen in Millisekunden angezeigt werden. Es wird standardmäßig auf 3000 ms. Weitere Informationen finden Sie unter Symbole und Splash-Screens.

"SplashMaintainAspectRatio" Präferenz ist optional. Wenn wahr, Splash-Screen zeichenbaren nicht gestreckt wird, um den Bildschirm passen, sondern stattdessen einfach "" den Bildschirm, wie CSS abdeckt "Hintergrund-Größe: Schutz vor". Dies ist sehr nützlich, wenn Splash-Bildschirm Bilder können nicht, in keiner Weise, zum Beispiel verzerrt werden wenn sie Landschaft oder Text enthalten. Diese Einstellung funktioniert am besten mit Bildern, die große Margen (sichere Bereiche) haben, die sicher auf Bildschirme mit unterschiedlichen Seitenverhältnissen zugeschnitten werden können.

Das Plugin lädt platsch zeichenbaren wenn Ausrichtung ändert, sodass Sie verschiedene Drawables für hoch- und Querformat Ausrichtungen angeben können.

Browser-Eigenheiten

In Ihrem "config.xml"können Sie die folgenden Einstellungen:

<platform name="browser">
    <preference name="SplashScreen" value="images/browser/splashscreen.jpg" /> <!-- defaults to "img/logo.png" -->
    <preference name="SplashScreenDelay" value="10000" /> <!-- defaults to "3000" -->
    <preference name="SplashScreenBackgroundColor" value="green" /> <!-- defaults to "#464646" -->
    <preference name="ShowSplashScreen" value="false" /> <!-- defaults to "true" -->
    <preference name="SplashScreenWidth" value="600" /> <!-- defaults to "170" -->
    <preference name="SplashScreenHeight" value="300" /> <!-- defaults to "200" -->
</platform>

iOS Macken

FadeSplashScreen (Boolean, standardmäßig auf true festgelegt): um zu verhindern, dass den Begrüßungsbildschirm ein-und ausblenden bei ihrer Anzeige Statusänderungen auf false festgelegt.
```
<preference name="FadeSplashScreen" value="false"/>
```
FadeSplashScreenDuration (float, Standardwert ist 2): gibt die Anzahl der Sekunden für den Begrüßungsbildschirm fade Effekt ausgeführt.
```
<preference name="FadeSplashScreenDuration" value="4"/>
```
ShowSplashScreenSpinner (Boolean, standardmäßig auf true festgelegt): auf false festgelegt wird, um den Begrüßungsbildschirm Spinner auszublenden.
```
<preference name="ShowSplashScreenSpinner" value="false"/>
```

SplashScreen.Hide

Schließen Sie den Splash-Screen.

navigator.splashscreen.hide();

BlackBerry 10, WP8, iOS Eigenarten

Die Datei config.xml AutoHideSplashScreen Einstellung muss false sein. Verstecken des Begrüßungsbildschirms für zwei Sekunden Verzögerung, fügen Sie einen Timer wie die folgende in der deviceready-Ereignishandler:

    setTimeout(function() {
        navigator.splashscreen.hide();
    }, 2000);

SplashScreen.Show

Zeigt den Begrüßungsbildschirm.

navigator.splashscreen.show();

Ihre Anwendung kann nicht navigator.splashscreen.show() aufrufen, bis die app begonnen hat und das deviceready-Ereignis ausgelöst hat. Aber da in der Regel der Splash-Screen soll sichtbar sein, bevor die Anwendung gestartet wurde, scheint die Niederlage der Zweck des Begrüßungsbildschirms. Somit einige Konfiguration in der Datei config.xml werden automatisch die Splash show sofort nach Ihrer app-Start und Bildschirm bevor es voll begonnen hat, und das deviceready-Ereignis empfangen. Weitere Informationen zu dieser Konfiguration finden Sie unter Symbole und Splash-Screens. Aus diesem Grund ist es unwahrscheinlich, dass Sie navigator.splashscreen.show() damit den Splash-Screen sichtbar ist für app-Start aufrufen müssen.

5.8 KiB Raw Blame History