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
 24Ten plugin wyświetla i ukrywa ekran powitalny podczas uruchamiania aplikacji.
 25
 26## Instalacja
 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## Obsługiwane platformy
 35
 36  * Amazon Fire OS
 37  * Android
 38  * BlackBerry 10
 39  * iOS
 40  * Windows Phone 7 i 8
 41  * Windows 8
 42  * Windows
 43  * Przeglądarka
 44
 45## Metody
 46
 47  * splashscreen.show
 48  * splashscreen.Hide
 49
 50### Dziwactwa Androida
 51
 52W pliku `config.xml`musisz dodać następujące preferencje:
 53
 54    <preference name="SplashScreen" value="foo" />
 55    <preference name="SplashScreenDelay" value="10000" />
 56    <preference name="SplashMaintainAspectRatio" value="true|false" />
 57    
 58
 59Gdzie foo jest nazwą pliku ekranu powitalnego, najlepiej 9 łatce. Upewnij się dodać pliki splashcreen do katalogu res/xml w odpowiednich folderach. Drugi parametr reprezentuje, jak długo ekranu powitalnego pojawi się w milisekundach. Domyślnie 3000 ms. Aby uzyskać więcej informacji, zobacz [ikony i ekrany powitalne w aplikacjach](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html).
 60
 61"SplashMaintainAspectRatio" preferencji jest opcjonalne. Jeśli zestaw na wartość true, ekran powitalny dolarowe nie jest rozciągnięty do ekranów, ale zamiast po prostu "obejmuje" ekranu, jak CSS "tło-rozmiar: okładka". Jest to bardzo przydatne, kiedy opryskać tęcza obrazy nie zniekształcony w jakikolwiek sposób, na przykład, gdy zawierają one dekoracje lub tekst. To ustawienie działa najlepiej z obrazów, które mają duże marginesy (bezpiecznych obszarów), które mogą być bezpiecznie przycięte na ekrany z różnych proporcji.
 62
 63Plugin ładuje rozchlapać dolarowe, gdy zmienia orientację, tak można określić różnych drawables do orientacji pionowej i poziomej.
 64
 65### Quirks przeglądarki
 66
 67W pliku `config.xml`można użyć następujące preferencje:
 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### Dziwactwa iOS
 80
 81  * `FadeSplashScreen` (wartość logiczna, domyślnie `true`): zestaw na `false` , aby zapobiec Znikająca i odkładane po zmianie stanu wyświetlania ekranu powitalnego.
 82    
 83        <preference name="FadeSplashScreen" value="false"/>
 84        
 85
 86  * `FadeSplashScreenDuration` (float, domyślnie `2`): określa liczbę sekund dla ekranu powitalnego zanikanie efekt do wykonać.
 87    
 88        <preference name="FadeSplashScreenDuration" value="4"/>
 89        
 90
 91  * `ShowSplashScreenSpinner` (wartość logiczna, domyślnie `true`): zestaw na `false` , aby ukryć pokrętła ekran powitalny.
 92    
 93        <preference name="ShowSplashScreenSpinner" value="false"/>
 94        
 95
 96## splashscreen.Hide
 97
 98Odrzucić ten opryskaæ têcza.
 99
100    navigator.splashscreen.hide();
101    
102
103### Jeżyna 10, WP8, iOS dziwactwo
104
105Plik `config.xml` `AutoHideSplashScreen` ustawienie musi być `false`. Opóźnienia, ukrywanie ekranu powitalnego przez dwie sekundy, dodać timer następujących w `deviceready` obsługa zdarzeń:
106
107        setTimeout(function() {
108            navigator.splashscreen.hide();
109        }, 2000);
110    
111
112## splashscreen.show
113
114Wyświetla ekran powitalny.
115
116    navigator.splashscreen.show();
117    
118
119Aplikacja nie można wywołać `navigator.splashscreen.show()`, aż aplikacja została uruchomiona i zdarzenie `deviceready` został zwolniony. Ale ponieważ zazwyczaj opryskać tęcza ma być widoczne przed rozpoczęciem aplikacji, wydaje się sprzeczne z celem ekranu powitalnego. Dostarczanie niektórych konfiguracji w `pliku config.xml` będzie automatycznie `show` splash na ekranie natychmiast po uruchomienie aplikacji i przed pełni rozpoczął i odebrał zdarzenie `deviceready`. Aby uzyskać więcej informacji na robienie tej konfiguracji, zobacz [ikony i ekrany powitalne w aplikacjach](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html). Z tego powodu jest mało prawdopodobne, należy zadzwonić `navigator.splashscreen.show()`, aby wyświetlić ekran powitalny dla uruchamiania aplikacji.