license: > Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Esta sección le muestra cómo configurar de una aplicación icono y pantalla opcional para varias plataformas, tanto si se trabaja en la CLI de Cordova (descrito en la interfaz de línea de comandos) o si se utilizan herramientas específicas de la plataforma SDK (detallada en las guías de plataforma).
Cuando se trabaja en la CLI, archivos de código fuente del icono se encuentran en diferentes subdirectorios específicos a una plataforma dentro del directorio del proyecto www/res/icons
. Los proyectos recién creados cuentan con un conjunto de iconos predeterminados de Cordova para reemplazar según la plataforma seleccionada.
Android especifica iconos de baja, media, alta y extra alta resolución:
android/icon-36-ldpi.png android/icon-48-mdpi.png android/icon-72-hdpi.png android/icon-96-xhdpi.png
La plataforma iOS especifica 72-pixel-cuadrado iconos para iPads y muestra iconos 57-pixel para iPhones y iPods, con variantes de alta resolución 2 x para la retina:
ios/icon-57-2x.png ios/icon-57.png ios/icon-72-2x.png ios/icon-72.png
Windows Phone especifica un icono predeterminado 48 píxeles, junto con fondo de diversos dispositivos imágenes utilizadas al representar aplicaciones de revestimientos:
windows-phone/icon-48.png windows-phone/icon-62-tile.png windows-phone/icon-173-tile.png
Blackberry 10 requiere que sea especificado un elemento icon en config.xml:
<icon src="blackberry10/icon-86.png" />
Consulte la documentación de BlackBerry para apuntar varios tamaños y configuraciones regionales.
[http://developer.blackberry.com/html5/documentation/icon_element.html]
Tizen requiere un ícono de 128-pixel:
tizen/icon-128.png
Utilizar la API Splashscreen para activar la visualización de la pantalla de presentación introductoria de una app en muchas plataformas. Cuando se está trabajando en el CLI, los archivos de la splash screen se encuentran dentro del subdirectorio del proyecto www/res/screens
.
Android especifica las imágenes de las splash screen en ambas orientaciones, portrait y landscape, para las resoluciones baja, media, alta y extra-alta:
android/screen-hdpi-landscape.png android/screen-hdpi-portrait.png android/screen-ldpi-landscape.png android/screen-ldpi-portrait.png android/screen-mdpi-landscape.png android/screen-mdpi-portrait.png android/screen-xhdpi-landscape.png android/screen-xhdpi-portrait.png
La plataforma iOS especifica las variantes para iPhone/iPod y iPad, con variantes para las exhibiciones de la retina y orientaciones diferentes. El archivo 568 h se aplica para el iPhone de 5 pantalla más alta:
ios/screen-ipad-landscape-2x.png ios/screen-ipad-landscape.png ios/screen-ipad-portrait-2x.png ios/screen-ipad-portrait.png ios/screen-iphone-landscape-2x.png ios/screen-iphone-landscape.png ios/screen-iphone-portrait-2x.png ios/screen-iphone-portrait.png ios/screen-iphone-portrait-568h-2x.png
Windows Phone especifica una imagen de la pantalla splash solo:
windows-phone/screen-portrait.jpg
Las siguientes secciones detallan cómo configurar salpicadura pantallas cuando trabajo con SDK y las herramientas de línea de comandos relacionados con descrito en las guías de la plataforma.
No olvide instalar el plugin SplashScreen antes de intentar usar el navigator.splashscreen.hide()
o navigator.splashscreen.show()
los métodos.
Ubica los archivos 9-patch image dentro de los directorios del proyecto Android platforms/android/res/drawable*
.
La resolución para cada uno debe ser:
Cuando se crea un nuevo proyecto Android, la pantalla de inicio por defecto imágenes siempre en la Córdoba muestra app ya debe estar presente en la platforms/android/res/drawable*
directorios. No dude en sustituir estos con sus propias imágenes. Al proporcionar su propio toque imágenes en pantalla, no necesitas proporcionar la misma permutación de 8 como Cordova predeterminado que aquí. Más o menos optimización puede ser utilizado. El drawable
nombres de directorio deben seguir las convenciones Android por apoyar a tamaños de pantalla y recursos alternativos.
En el nivel superior config.xml
archivo (no el que está en platforms
), agregue las siguientes preferencias:
<preference name="SplashScreen" value="screen" /> <preference name="SplashScreenDelay" value="10000" />
La primera línea establece la imagen que se mostrará como la pantalla de bienvenida. Este es el nombre del archivo de la png en el drawable*
directorios, menos la .png
extensión. El valor predeterminado para SplashScreen es screen
(para el archivo platforms/android/res/drawable*/screen.png
), así que si usted nombrar la imagen nada aparte de screen.png
en el drawable*
directorios, necesitas añadir/modificar esta línea.
La segunda línea establece la demora por defecto de cuánto el splashscreen aparece en milisegundos. Esto debería ser la peor hora prevista. El valor predeterminado para SplashScreenDelay es ms 3000.
Finalmente, como una mejor práctica, la pantalla de bienvenida debe estar presente sólo el tiempo necesario. Cuando su aplicación ha comenzado y se ha cargado el webview, su aplicación debe ocultar la pantalla de bienvenida para que su vista principal es visible en cuanto esté listo. Debido a la hora de inicio de la aplicación variará un poco debido a una serie de factores como la velocidad de la CPU y de red, se recomienda que su aplicación invocar explícitamente navigator.splashscreen.hide()
en el método JavaScript que responde a la [deviceready](../cordova/events/events.deviceready.html)
evento. De lo contrario la pantalla de bienvenida será visible para el valor de SplashScreenDelay que ha configurado anteriormente, más de lo necesario que es probable. Este enfoque orientado al evento es altamente recomendable versus tener la pantalla visible para siempre una duración fija.
Copiar imágenes de pantalla de splash en el proyecto iOS Resources/splash
Directorio. Sólo agregar esas imágenes para los dispositivos que desea apoyar, como el iPad o el iPhone. El tamaño de cada imagen debe ser:
Añadir un elemento de borde: splash en config.xml para cada resolución y configuración regional que desea apoyar:
http://developer.BlackBerry.com/HTML5/Documentation/rim_splash_element.html