@capacitor/splash-screen 4.1.4-nightly-20230119T152145.0 → 4.1.4-nightly-20230120T152220.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -24
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -9,6 +9,28 @@ npm install @capacitor/splash-screen
|
|
|
9
9
|
npx cap sync
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
+
### Android 12 Splash Screen API
|
|
13
|
+
|
|
14
|
+
_**This only affects the launch splash screen and is not used when utilizing the programmatic `show()` method.**_
|
|
15
|
+
|
|
16
|
+
Capacitor 4 uses the **[Android 12 Splash Screen API](https://developer.android.com/guide/topics/ui/splash-screen)** and the `androidx.core:core-splashscreen` compatibility library to make it work on Android 11 and below.
|
|
17
|
+
|
|
18
|
+
The compatibility library can be disabled by changing the parent of `AppTheme.NoActionBarLaunch` from `Theme.SplashScreen` to `AppTheme.NoActionBar` in `android/app/src/main/res/values/styles.xml`.
|
|
19
|
+
The Android 12 Splash Screen API can't be disabled on Android 12+ as it's part of the Android OS.
|
|
20
|
+
|
|
21
|
+
```xml
|
|
22
|
+
<style name="AppTheme.NoActionBarLaunch" parent="AppTheme.NoActionBar">
|
|
23
|
+
<item name="android:background">@drawable/splash</item>
|
|
24
|
+
</style>
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
**NOTE**: On Android 12 and Android 12L devices the Splash Screen image is not showing when launched from third party launchers such as Nova Launcher, MIUI, Realme Launcher, OPPO Launcher, etc., from app info in Settings App, or from IDEs such as Android Studio.
|
|
28
|
+
**[Google Issue Tracker](https://issuetracker.google.com/issues/205021357)**
|
|
29
|
+
**[Google Issue Tracker](https://issuetracker.google.com/issues/207386164)**
|
|
30
|
+
Google have fixed those problems on Android 13 but they won't be backport the fixes to Android 12 and Android 12L.
|
|
31
|
+
Launcher related issues might get fixed by a launcher update.
|
|
32
|
+
If you still find issues related to the Splash Screen on Android 13, please, report them to [Google](https://issuetracker.google.com/).
|
|
33
|
+
|
|
12
34
|
## Example
|
|
13
35
|
|
|
14
36
|
```typescript
|
|
@@ -156,30 +178,6 @@ To use splash screen images named something other than `splash.png`, set `androi
|
|
|
156
178
|
</style>
|
|
157
179
|
```
|
|
158
180
|
|
|
159
|
-
### Android 12 Splash Screen API
|
|
160
|
-
|
|
161
|
-
_**This only affects the launch splash screen and is not used when utilizing the programmatic `show()` method.**_
|
|
162
|
-
|
|
163
|
-
To enable the new recommended **[Android 12 Splash Screen API](https://developer.android.com/guide/topics/ui/splash-screen)** in SDK Versions 30 or below:
|
|
164
|
-
|
|
165
|
-
_This is enabled by default and required for SDK version 31+._
|
|
166
|
-
|
|
167
|
-
- Add `$coreSplashScreenVersion` to the `variables.gradle` file.
|
|
168
|
-
_See Variables Section for more information_
|
|
169
|
-
|
|
170
|
-
- Add `implementation "androidx.core:core-splashscreen:$coreSplashScreenVersion"` in the dependencies section of `/android/app/build.gradle`.
|
|
171
|
-
|
|
172
|
-
- In `android/app/src/main/res/values/styles.xml`, edit the theme `parent` attribute on the Applications's MainActivity Theme to `Theme.SplashScreen` and add desired options to the theme.
|
|
173
|
-
|
|
174
|
-
```xml
|
|
175
|
-
<style name="AppTheme.NoActionBarLaunch" parent="Theme.SplashScreen">
|
|
176
|
-
<item name="android:background">@drawable/splash</item>
|
|
177
|
-
</style>
|
|
178
|
-
```
|
|
179
|
-
|
|
180
|
-
**NOTE**: Some issues may exist on SDK >= 31 when using the new API for the splash screen, which pertain to the splash screen only showing when launched from the launcher icon.
|
|
181
|
-
**[Google Issue Tracker](https://issuetracker.google.com/issues/205021357)**
|
|
182
|
-
|
|
183
181
|
## Variables
|
|
184
182
|
|
|
185
183
|
This plugin will use the following project variables (defined in your app's `variables.gradle` file):
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@capacitor/splash-screen",
|
|
3
|
-
"version": "4.1.4-nightly-
|
|
3
|
+
"version": "4.1.4-nightly-20230120T152220.0",
|
|
4
4
|
"description": "The Splash Screen API provides methods for showing or hiding a Splash image.",
|
|
5
5
|
"main": "dist/plugin.cjs.js",
|
|
6
6
|
"module": "dist/esm/index.js",
|
|
@@ -80,5 +80,5 @@
|
|
|
80
80
|
"publishConfig": {
|
|
81
81
|
"access": "public"
|
|
82
82
|
},
|
|
83
|
-
"gitHead": "
|
|
83
|
+
"gitHead": "b07f3054e681dcdad1c892515e9c6b3b8759b9d5"
|
|
84
84
|
}
|