You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

118 lines
5.8 KiB

7 years ago
  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. # cordova-plugin-splashscreen
  20. [![Build Status](https://travis-ci.org/apache/cordova-plugin-splashscreen.svg)](https://travis-ci.org/apache/cordova-plugin-splashscreen)
  21. Dieses Plugin zeigt und verbirgt einen Splash-Screen beim Start der Anwendung.
  22. ## Installation
  23. // npm hosted (new) id
  24. cordova plugin add cordova-plugin-splashscreen
  25. // you may also install directly from this repo
  26. cordova plugin add https://github.com/apache/cordova-plugin-splashscreen.git
  27. ## Unterstützte Plattformen
  28. * Amazon Fire OS
  29. * Android
  30. * BlackBerry 10
  31. * iOS
  32. * Windows Phone 7 und 8
  33. * Windows 8
  34. * Windows
  35. * Browser
  36. ## Methoden
  37. * SplashScreen.Show
  38. * SplashScreen.Hide
  39. ### Android Eigenarten
  40. Sie müssen in Ihrem `"config.xml"`fügen Sie die folgenden Einstellungen:
  41. <preference name="SplashScreen" value="foo" />
  42. <preference name="SplashScreenDelay" value="10000" />
  43. <preference name="SplashMaintainAspectRatio" value="true|false" />
  44. 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](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html).
  45. "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.
  46. Das Plugin lädt platsch zeichenbaren wenn Ausrichtung ändert, sodass Sie verschiedene Drawables für hoch- und Querformat Ausrichtungen angeben können.
  47. ### Browser-Eigenheiten
  48. In Ihrem `"config.xml"`können Sie die folgenden Einstellungen:
  49. <platform name="browser">
  50. <preference name="SplashScreen" value="images/browser/splashscreen.jpg" /> <!-- defaults to "img/logo.png" -->
  51. <preference name="SplashScreenDelay" value="10000" /> <!-- defaults to "3000" -->
  52. <preference name="SplashScreenBackgroundColor" value="green" /> <!-- defaults to "#464646" -->
  53. <preference name="ShowSplashScreen" value="false" /> <!-- defaults to "true" -->
  54. <preference name="SplashScreenWidth" value="600" /> <!-- defaults to "170" -->
  55. <preference name="SplashScreenHeight" value="300" /> <!-- defaults to "200" -->
  56. </platform>
  57. ### iOS Macken
  58. * `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.
  59. <preference name="FadeSplashScreen" value="false"/>
  60. * `FadeSplashScreenDuration` (float, Standardwert ist `2`): gibt die Anzahl der Sekunden für den Begrüßungsbildschirm fade Effekt ausgeführt.
  61. <preference name="FadeSplashScreenDuration" value="4"/>
  62. * `ShowSplashScreenSpinner` (Boolean, standardmäßig auf `true festgelegt`): auf `false` festgelegt wird, um den Begrüßungsbildschirm Spinner auszublenden.
  63. <preference name="ShowSplashScreenSpinner" value="false"/>
  64. ## SplashScreen.Hide
  65. Schließen Sie den Splash-Screen.
  66. navigator.splashscreen.hide();
  67. ### BlackBerry 10, WP8, iOS Eigenarten
  68. 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:
  69. setTimeout(function() {
  70. navigator.splashscreen.hide();
  71. }, 2000);
  72. ## SplashScreen.Show
  73. Zeigt den Begrüßungsbildschirm.
  74. navigator.splashscreen.show();
  75. 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](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.