1<!--
  2# license: Licensed to the Apache Software Foundation (ASF) under one
  3#         or more contributor license agreements.  See the NOTICE file
  4#         distributed with this work for additional information
  5#         regarding copyright ownership.  The ASF licenses this file
  6#         to you under the Apache License, Version 2.0 (the
  7#         "License"); you may not use this file except in compliance
  8#         with the License.  You may obtain a copy of the License at
  9#
 10#           http://www.apache.org/licenses/LICENSE-2.0
 11#
 12#         Unless required by applicable law or agreed to in writing,
 13#         software distributed under the License is distributed on an
 14#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 15#         KIND, either express or implied.  See the License for the
 16#         specific language governing permissions and limitations
 17#         under the License.
 18-->
 19
 20# cordova-plugin-splashscreen
 21
 22[![Build Status](https://travis-ci.org/apache/cordova-plugin-splashscreen.svg)](https://travis-ci.org/apache/cordova-plugin-splashscreen)
 23
 24Dieses Plugin zeigt und verbirgt einen Splash-Screen beim Start der Anwendung.
 25
 26## Installation
 27
 28    // npm hosted (new) id
 29    cordova plugin add cordova-plugin-splashscreen
 30    // you may also install directly from this repo
 31    cordova plugin add https://github.com/apache/cordova-plugin-splashscreen.git
 32    
 33
 34## Unterstützte Plattformen
 35
 36  * Amazon Fire OS
 37  * Android
 38  * BlackBerry 10
 39  * iOS
 40  * Windows Phone 7 und 8
 41  * Windows 8
 42  * Windows
 43  * Browser
 44
 45## Methoden
 46
 47  * SplashScreen.Show
 48  * SplashScreen.Hide
 49
 50### Android Eigenarten
 51
 52Sie müssen in Ihrem `"config.xml"`fügen Sie die folgenden Einstellungen:
 53
 54    <preference name="SplashScreen" value="foo" />
 55    <preference name="SplashScreenDelay" value="10000" />
 56    <preference name="SplashMaintainAspectRatio" value="true|false" />
 57    
 58
 59Wo 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](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html).
 60
 61"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.
 62
 63Das Plugin lädt platsch zeichenbaren wenn Ausrichtung ändert, sodass Sie verschiedene Drawables für hoch- und Querformat Ausrichtungen angeben können.
 64
 65### Browser-Eigenheiten
 66
 67In Ihrem `"config.xml"`können Sie die folgenden Einstellungen:
 68
 69    <platform name="browser">
 70        <preference name="SplashScreen" value="images/browser/splashscreen.jpg" /> <!-- defaults to "img/logo.png" -->
 71        <preference name="SplashScreenDelay" value="10000" /> <!-- defaults to "3000" -->
 72        <preference name="SplashScreenBackgroundColor" value="green" /> <!-- defaults to "#464646" -->
 73        <preference name="ShowSplashScreen" value="false" /> <!-- defaults to "true" -->
 74        <preference name="SplashScreenWidth" value="600" /> <!-- defaults to "170" -->
 75        <preference name="SplashScreenHeight" value="300" /> <!-- defaults to "200" -->
 76    </platform>
 77    
 78
 79### iOS Macken
 80
 81  * `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.
 82    
 83        <preference name="FadeSplashScreen" value="false"/>
 84        
 85
 86  * `FadeSplashScreenDuration` (float, Standardwert ist `2`): gibt die Anzahl der Sekunden für den Begrüßungsbildschirm fade Effekt ausgeführt.
 87    
 88        <preference name="FadeSplashScreenDuration" value="4"/>
 89        
 90
 91  * `ShowSplashScreenSpinner` (Boolean, standardmäßig auf `true festgelegt`): auf `false` festgelegt wird, um den Begrüßungsbildschirm Spinner auszublenden.
 92    
 93        <preference name="ShowSplashScreenSpinner" value="false"/>
 94        
 95
 96## SplashScreen.Hide
 97
 98Schließen Sie den Splash-Screen.
 99
100    navigator.splashscreen.hide();
101    
102
103### BlackBerry 10, WP8, iOS Eigenarten
104
105Die 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:
106
107        setTimeout(function() {
108            navigator.splashscreen.hide();
109        }, 2000);
110    
111
112## SplashScreen.Show
113
114Zeigt den Begrüßungsbildschirm.
115
116    navigator.splashscreen.show();
117    
118
119Ihre 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](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html). Aus diesem Grund ist es unwahrscheinlich, dass Sie `navigator.splashscreen.show()` damit den Splash-Screen sichtbar ist für app-Start aufrufen müssen.