You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
feat(android)!: remove platform from plugin (#337)
* feat(android): drop source code
* feat(android): remove from docs
* feat(android): remove ci
* feat(android): remove dependency requirements
* feat(android): remove from config.xml
* feat(android): revert removal of android version requirements
* feat(anroid): do not install on 7.0.0 or above
This plugin displays and hides a splash screen while your web application is launching. Using its methods you can also show and hide the splash screen manually.
29
29
@@ -32,17 +32,10 @@ This plugin displays and hides a splash screen while your web application is lau
If using `[email protected]` or later and exclusively developing for Android, this plugin can be uninstalled.
66
55
- Windows (`cordova-windows` version >= 4.4.0 is required)
67
-
__Note__: Extended splashscreen does not require the plugin on Windows (as opposed to Android) in case you don't use the plugin API, i.e. programmatic hide/show.
56
+
__Note__: Extended splashscreen does not require the plugin on Windows in case you don't use the plugin API, i.e. programmatic hide/show.
To effectively create your Android SplashScreen assets, it is important to understand the idiom and sizes used for the assets.
130
-
131
-
Android defined its assets by the image's layout and `density`.
132
-
133
-
#### Image Layout
134
-
135
-
-`land` short for landscape mode
136
-
-`port` short for portrait mode
137
-
138
-
#### `density`
139
-
140
-
The image's density refers to the number of pixels per square inch. Android, interchangeably refers to this as DPI.
141
-
142
-
Not all devices have the same pixel size so it is important to create images for all DPI to ensure that the quality of the image for each device is great.
143
-
144
-
If not all DPI images are considered, some devices might not show a SplashScreen or will use an incorrect DPI image that can result in a blurry scaled image.
145
-
146
-
#### Image Sizing Table
147
-
148
-
| size | portrait | landscape |
149
-
| :-----: | :-------: | :-------: |
150
-
| ldpi | 200x320 | 320x200 |
151
-
| mdpi | 320x480 | 480x320 |
152
-
| hdpi | 480x800 | 800x480 |
153
-
| xhdpi | 720x1280 | 1280x720 |
154
-
| xxhdpi | 960x1600 | 1600x960 |
155
-
| xxxhdpi | 1280x1920 | 1920x1280 |
156
-
157
-
#### Dark Mode (API 28+)
158
-
159
-
You can optionally provide an extra SplashScreen image to be used in dark/night mode when enabled on supported devices.
160
-
To do this, add the `-night` keyword in between the **layout** and **size** keywords of the image's `density` attribute value. E.g.: `land-night-hdpi`
161
-
162
-
For more examples, please see [the Example Configuration](#example-android-configuration) section.
163
-
164
-
#### Example Android Configuration
165
-
166
-
```xml
167
-
<platformname="android">
168
-
<!-- Default
169
-
Note: You should specify default resources for each density.
170
-
-- For instance, if the device(hdpi) is in landscape orientation and [density="land-hdpi"]
171
-
-- does not exists, [density="hdpi"] will be selected
172
-
If you do not declare this you will get MissingDefaultResource lint check errors.
`SplashMaintainAspectRatio` preference is optional. If set to `true`, the splash screen drawable is not stretched to fit the full screen, but instead simply "covers" the screen, like CSS "background-size:cover". This is very useful when splash screen images cannot be distorted in any way, for example when they contain scenery or text. This setting works best with images that have large margins (safe areas) that can be safely cropped on screens with different aspect ratios.
318
-
319
-
The splash screen plugin reloads the splash screen whenever the orientation changes so that you can specify different splash screen images for portrait and landscape orientations.
320
-
321
-
`SplashShowOnlyFirstTime` preference is optional and defaults to `true`. When set to `true` the splash screen will only appear on application launch. However, if you plan to use `navigator.app.exitApp()` to close the application and force the splash screen appear on the application's next launch, you should set this property to `false` (this also applies to closing the application with the Back button).
322
-
323
-
`SplashScreenSpinnerColor` preference is also optional and is ignored when not set. Setting it to a valid color name or HEX color code will change the color of the spinner on Android 5.0+ devices.
324
-
325
193
#### Browser Quirks
326
194
327
195
You can use the following preferences in your `config.xml`:
0 commit comments