expo-application 4.0.0 → 4.0.1

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.
Files changed (8) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/README.md +1 -1
  3. package/android/build.gradle +2 -2
  4. package/build/Application.d.ts +17 -11
  5. package/build/Application.js +17 -11
  6. package/build/Application.js.map +1 -1
  7. package/package.json +6 -2
  8. package/src/Application.ts +17 -11
package/CHANGELOG.md CHANGED
@@ -10,6 +10,10 @@
10
10
 
11
11
  ### 💡 Others
12
12
 
13
+ ## 4.0.1 — 2021-11-17
14
+
15
+ _This version does not introduce any user-facing changes._
16
+
13
17
  ## 4.0.0 — 2021-09-28
14
18
 
15
19
  ### 🛠 Breaking changes
package/README.md CHANGED
@@ -12,7 +12,7 @@ For managed [managed](https://docs.expo.io/versions/latest/introduction/managed-
12
12
 
13
13
  # Installation in bare React Native projects
14
14
 
15
- For bare React Native projects, you must ensure that you have [installed and configured the `react-native-unimodules` package](https://github.com/expo/expo/tree/master/packages/react-native-unimodules) before continuing.
15
+ For bare React Native projects, you must ensure that you have [installed and configured the `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) before continuing.
16
16
 
17
17
  ### Add the package to your npm dependencies
18
18
 
package/android/build.gradle CHANGED
@@ -3,7 +3,7 @@ apply plugin: 'kotlin-android'
3
3
  apply plugin: 'maven'
4
4
 
5
5
  group = 'host.exp.exponent'
6
- version = '4.0.0'
6
+ version = '4.0.1'
7
7
 
8
8
  buildscript {
9
9
  // Simple helper that allows the root project to override versions declared by this library.
@@ -57,7 +57,7 @@ android {
57
57
  minSdkVersion safeExtGet("minSdkVersion", 21)
58
58
  targetSdkVersion safeExtGet("targetSdkVersion", 30)
59
59
  versionCode 12
60
- versionName '4.0.0'
60
+ versionName '4.0.1'
61
61
  }
62
62
  lintOptions {
63
63
  abortOnError false
package/build/Application.d.ts CHANGED
@@ -3,7 +3,7 @@
3
3
  * This is the `Info.plist` value for `CFBundleShortVersionString` on iOS and the version name set
4
4
  * by `version` in `app.json` on Android at the time the native app was built.
5
5
  * On web, this value is `null`.
6
- * - E.g., `"2.11.0"`
6
+ * @example `"2.11.0"`
7
7
  */
8
8
  export declare const nativeApplicationVersion: string | null;
9
9
  /**
@@ -12,24 +12,24 @@ export declare const nativeApplicationVersion: string | null;
12
12
  * `ios.buildNumber` value in `app.json` in a standalone app) and the version code set by
13
13
  * `android.versionCode` in `app.json` on Android at the time the native app was built. On web, this
14
14
  * value is `null`. The return type on Android and iOS is `string`.
15
- * - E.g., iOS: `"2.11.0"`, Android: `"114"`
15
+ * @example iOS: `"2.11.0"`, Android: `"114"`
16
16
  */
17
17
  export declare const nativeBuildVersion: string | null;
18
18
  /**
19
19
  * The human-readable name of the application that is displayed with the app's icon on the device's
20
20
  * home screen or desktop. On Android and iOS, this value is a `string` unless the name could not be
21
21
  * retrieved, in which case this value will be `null`. On web this value is `null`.
22
- * - E.g., `"Expo"`, `"Yelp"`, `"Instagram"`
22
+ * @example `"Expo"`, `"Yelp"`, `"Instagram"`
23
23
  */
24
24
  export declare const applicationName: string | null;
25
25
  /**
26
26
  * The ID of the application. On Android, this is the application ID. On iOS, this is the bundle ID.
27
27
  * On web, this is `null`.
28
- * - E.g., `"com.cocoacasts.scribbles"`, `"com.apple.Pages"`
28
+ * @example `"com.cocoacasts.scribbles"`, `"com.apple.Pages"`
29
29
  */
30
30
  export declare const applicationId: string | null;
31
31
  /**
32
- * **Android only.** The value of [`Settings.Secure.ANDROID_ID`](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID).
32
+ * The value of [`Settings.Secure.ANDROID_ID`](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID).
33
33
  * This is a hexadecimal `string` unique to each combination of app-signing key, user, and device.
34
34
  * The value may change if a factory reset is performed on the device or if an APK signing key changes.
35
35
  * For more information about how the platform handles `ANDROID_ID` in Android 8.0 (API level 26)
@@ -38,11 +38,12 @@ export declare const applicationId: string | null;
38
38
  * > In versions of the platform lower than Android 8.0 (API level 26), this value remains constant
39
39
  * > for the lifetime of the user's device. See the [ANDROID_ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID)
40
40
  * > official docs for more information.
41
- * - E.g., `"dd96dec43fb81c97"`
41
+ * @example `"dd96dec43fb81c97"`
42
+ * @platform android
42
43
  */
43
44
  export declare const androidId: string | null;
44
45
  /**
45
- * **Android only.** Gets the referrer URL of the installed app with the [`Install Referrer API`](https://developer.android.com/google/play/installreferrer)
46
+ * Gets the referrer URL of the installed app with the [`Install Referrer API`](https://developer.android.com/google/play/installreferrer)
46
47
  * from the Google Play Store. In practice, the referrer URL may not be a complete, absolute URL.
47
48
  * @return A `Promise` that fulfills with a `string` of the referrer URL of the installed app.
48
49
  *
@@ -51,10 +52,11 @@ export declare const androidId: string | null;
51
52
  * await Application.getInstallReferrerAsync();
52
53
  * // "utm_source=google-play&utm_medium=organic"
53
54
  * ```
55
+ * @platform android
54
56
  */
55
57
  export declare function getInstallReferrerAsync(): Promise<string>;
56
58
  /**
57
- * **iOS only.** Gets the iOS "identifier for vendor" ([IDFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor))
59
+ * Gets the iOS "identifier for vendor" ([IDFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor))
58
60
  * value, a string ID that uniquely identifies a device to the app’s vendor. This method may
59
61
  * sometimes return `nil`, in which case wait and call the method again later. This might happen
60
62
  * when the device has been restarted before the user has unlocked the device.
@@ -71,6 +73,7 @@ export declare function getInstallReferrerAsync(): Promise<string>;
71
73
  * await Application.getIosIdForVendorAsync();
72
74
  * // "68753A44-4D6F-1226-9C60-0050E4C00067"
73
75
  * ```
76
+ * @platform ios
74
77
  */
75
78
  export declare function getIosIdForVendorAsync(): Promise<string | null>;
76
79
  export declare enum ApplicationReleaseType {
@@ -82,15 +85,17 @@ export declare enum ApplicationReleaseType {
82
85
  APP_STORE = 5
83
86
  }
84
87
  /**
85
- * **iOS only.** Gets the iOS application release type.
88
+ * Gets the iOS application release type.
86
89
  * @return Returns a promise which fulfills with an [`ApplicationReleaseType`](#applicationreleasetype).
90
+ * @platform ios
87
91
  */
88
92
  export declare function getIosApplicationReleaseTypeAsync(): Promise<ApplicationReleaseType>;
89
93
  /**
90
- * **iOS only.** Gets the current [Apple Push Notification (APN)](https://developer.apple.com/documentation/bundleresources/entitlements/aps-environment?language=objc)
94
+ * Gets the current [Apple Push Notification (APN)](https://developer.apple.com/documentation/bundleresources/entitlements/aps-environment?language=objc)
91
95
  * service environment.
92
96
  * @return Returns a promise fulfilled with the string, either `'development'` or `'production'`,
93
97
  * based on the current APN environment.
98
+ * @platform ios
94
99
  */
95
100
  export declare function getIosPushNotificationServiceEnvironmentAsync(): Promise<string>;
96
101
  /**
@@ -112,7 +117,7 @@ export declare function getIosPushNotificationServiceEnvironmentAsync(): Promise
112
117
  */
113
118
  export declare function getInstallationTimeAsync(): Promise<Date>;
114
119
  /**
115
- * **Android only.** Gets the last time the app was updated from the Google Play Store.
120
+ * Gets the last time the app was updated from the Google Play Store.
116
121
  * @return Returns a `Promise` that fulfills with a `Date` object that specifies the last time
117
122
  * the app was updated via the Google Play Store).
118
123
  *
@@ -121,5 +126,6 @@ export declare function getInstallationTimeAsync(): Promise<Date>;
121
126
  * await Application.getLastUpdateTimeAsync();
122
127
  * // 2019-07-18T21:20:16.887Z
123
128
  * ```
129
+ * @platform android
124
130
  */
125
131
  export declare function getLastUpdateTimeAsync(): Promise<Date>;
package/build/Application.js CHANGED
@@ -6,7 +6,7 @@ import ExpoApplication from './ExpoApplication';
6
6
  * This is the `Info.plist` value for `CFBundleShortVersionString` on iOS and the version name set
7
7
  * by `version` in `app.json` on Android at the time the native app was built.
8
8
  * On web, this value is `null`.
9
- * - E.g., `"2.11.0"`
9
+ * @example `"2.11.0"`
10
10
  */
11
11
  export const nativeApplicationVersion = ExpoApplication
12
12
  ? ExpoApplication.nativeApplicationVersion || null
@@ -18,7 +18,7 @@ export const nativeApplicationVersion = ExpoApplication
18
18
  * `ios.buildNumber` value in `app.json` in a standalone app) and the version code set by
19
19
  * `android.versionCode` in `app.json` on Android at the time the native app was built. On web, this
20
20
  * value is `null`. The return type on Android and iOS is `string`.
21
- * - E.g., iOS: `"2.11.0"`, Android: `"114"`
21
+ * @example iOS: `"2.11.0"`, Android: `"114"`
22
22
  */
23
23
  export const nativeBuildVersion = ExpoApplication
24
24
  ? ExpoApplication.nativeBuildVersion || null
@@ -28,7 +28,7 @@ export const nativeBuildVersion = ExpoApplication
28
28
  * The human-readable name of the application that is displayed with the app's icon on the device's
29
29
  * home screen or desktop. On Android and iOS, this value is a `string` unless the name could not be
30
30
  * retrieved, in which case this value will be `null`. On web this value is `null`.
31
- * - E.g., `"Expo"`, `"Yelp"`, `"Instagram"`
31
+ * @example `"Expo"`, `"Yelp"`, `"Instagram"`
32
32
  */
33
33
  export const applicationName = ExpoApplication
34
34
  ? ExpoApplication.applicationName || null
@@ -37,14 +37,14 @@ export const applicationName = ExpoApplication
37
37
  /**
38
38
  * The ID of the application. On Android, this is the application ID. On iOS, this is the bundle ID.
39
39
  * On web, this is `null`.
40
- * - E.g., `"com.cocoacasts.scribbles"`, `"com.apple.Pages"`
40
+ * @example `"com.cocoacasts.scribbles"`, `"com.apple.Pages"`
41
41
  */
42
42
  export const applicationId = ExpoApplication
43
43
  ? ExpoApplication.applicationId || null
44
44
  : null;
45
45
  // @needsAudit
46
46
  /**
47
- * **Android only.** The value of [`Settings.Secure.ANDROID_ID`](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID).
47
+ * The value of [`Settings.Secure.ANDROID_ID`](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID).
48
48
  * This is a hexadecimal `string` unique to each combination of app-signing key, user, and device.
49
49
  * The value may change if a factory reset is performed on the device or if an APK signing key changes.
50
50
  * For more information about how the platform handles `ANDROID_ID` in Android 8.0 (API level 26)
@@ -53,12 +53,13 @@ export const applicationId = ExpoApplication
53
53
  * > In versions of the platform lower than Android 8.0 (API level 26), this value remains constant
54
54
  * > for the lifetime of the user's device. See the [ANDROID_ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID)
55
55
  * > official docs for more information.
56
- * - E.g., `"dd96dec43fb81c97"`
56
+ * @example `"dd96dec43fb81c97"`
57
+ * @platform android
57
58
  */
58
59
  export const androidId = ExpoApplication ? ExpoApplication.androidId || null : null;
59
60
  // @needsAudit
60
61
  /**
61
- * **Android only.** Gets the referrer URL of the installed app with the [`Install Referrer API`](https://developer.android.com/google/play/installreferrer)
62
+ * Gets the referrer URL of the installed app with the [`Install Referrer API`](https://developer.android.com/google/play/installreferrer)
62
63
  * from the Google Play Store. In practice, the referrer URL may not be a complete, absolute URL.
63
64
  * @return A `Promise` that fulfills with a `string` of the referrer URL of the installed app.
64
65
  *
@@ -67,6 +68,7 @@ export const androidId = ExpoApplication ? ExpoApplication.androidId || null : n
67
68
  * await Application.getInstallReferrerAsync();
68
69
  * // "utm_source=google-play&utm_medium=organic"
69
70
  * ```
71
+ * @platform android
70
72
  */
71
73
  export async function getInstallReferrerAsync() {
72
74
  if (!ExpoApplication.getInstallReferrerAsync) {
@@ -76,7 +78,7 @@ export async function getInstallReferrerAsync() {
76
78
  }
77
79
  // @needsAudit
78
80
  /**
79
- * **iOS only.** Gets the iOS "identifier for vendor" ([IDFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor))
81
+ * Gets the iOS "identifier for vendor" ([IDFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor))
80
82
  * value, a string ID that uniquely identifies a device to the app’s vendor. This method may
81
83
  * sometimes return `nil`, in which case wait and call the method again later. This might happen
82
84
  * when the device has been restarted before the user has unlocked the device.
@@ -93,6 +95,7 @@ export async function getInstallReferrerAsync() {
93
95
  * await Application.getIosIdForVendorAsync();
94
96
  * // "68753A44-4D6F-1226-9C60-0050E4C00067"
95
97
  * ```
98
+ * @platform ios
96
99
  */
97
100
  export async function getIosIdForVendorAsync() {
98
101
  if (!ExpoApplication.getIosIdForVendorAsync) {
@@ -112,8 +115,9 @@ export var ApplicationReleaseType;
112
115
  })(ApplicationReleaseType || (ApplicationReleaseType = {}));
113
116
  // @needsAudit
114
117
  /**
115
- * **iOS only.** Gets the iOS application release type.
118
+ * Gets the iOS application release type.
116
119
  * @return Returns a promise which fulfills with an [`ApplicationReleaseType`](#applicationreleasetype).
120
+ * @platform ios
117
121
  */
118
122
  export async function getIosApplicationReleaseTypeAsync() {
119
123
  if (!ExpoApplication.getApplicationReleaseTypeAsync) {
@@ -123,10 +127,11 @@ export async function getIosApplicationReleaseTypeAsync() {
123
127
  }
124
128
  // @needsAudit
125
129
  /**
126
- * **iOS only.** Gets the current [Apple Push Notification (APN)](https://developer.apple.com/documentation/bundleresources/entitlements/aps-environment?language=objc)
130
+ * Gets the current [Apple Push Notification (APN)](https://developer.apple.com/documentation/bundleresources/entitlements/aps-environment?language=objc)
127
131
  * service environment.
128
132
  * @return Returns a promise fulfilled with the string, either `'development'` or `'production'`,
129
133
  * based on the current APN environment.
134
+ * @platform ios
130
135
  */
131
136
  export async function getIosPushNotificationServiceEnvironmentAsync() {
132
137
  if (!ExpoApplication.getPushNotificationServiceEnvironmentAsync) {
@@ -161,7 +166,7 @@ export async function getInstallationTimeAsync() {
161
166
  }
162
167
  // @needsAudit
163
168
  /**
164
- * **Android only.** Gets the last time the app was updated from the Google Play Store.
169
+ * Gets the last time the app was updated from the Google Play Store.
165
170
  * @return Returns a `Promise` that fulfills with a `Date` object that specifies the last time
166
171
  * the app was updated via the Google Play Store).
167
172
  *
@@ -170,6 +175,7 @@ export async function getInstallationTimeAsync() {
170
175
  * await Application.getLastUpdateTimeAsync();
171
176
  * // 2019-07-18T21:20:16.887Z
172
177
  * ```
178
+ * @platform android
173
179
  */
174
180
  export async function getLastUpdateTimeAsync() {
175
181
  if (!ExpoApplication.getLastUpdateTimeAsync) {
package/build/Application.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"Application.js","sourceRoot":"","sources":["../src/Application.ts"],"names":[],"mappings":"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","sourcesContent":["import { UnavailabilityError } from 'expo-modules-core';\n\nimport ExpoApplication from './ExpoApplication';\n\n// @needsAudit\n/**\n * The human-readable version of the native application that may be displayed in the app store.\n * This is the `Info.plist` value for `CFBundleShortVersionString` on iOS and the version name set\n * by `version` in `app.json` on Android at the time the native app was built.\n * On web, this value is `null`.\n * - E.g., `\"2.11.0\"`\n */\nexport const nativeApplicationVersion: string | null = ExpoApplication\n ? ExpoApplication.nativeApplicationVersion || null\n : null;\n\n// @needsAudit\n/**\n * The internal build version of the native application that the app store may use to distinguish\n * between different binaries. This is the `Info.plist` value for `CFBundleVersion` on iOS (set with\n * `ios.buildNumber` value in `app.json` in a standalone app) and the version code set by\n * `android.versionCode` in `app.json` on Android at the time the native app was built. On web, this\n * value is `null`. The return type on Android and iOS is `string`.\n * - E.g., iOS: `\"2.11.0\"`, Android: `\"114\"`\n */\nexport const nativeBuildVersion: string | null = ExpoApplication\n ? ExpoApplication.nativeBuildVersion || null\n : null;\n\n// @needsAudit\n/**\n * The human-readable name of the application that is displayed with the app's icon on the device's\n * home screen or desktop. On Android and iOS, this value is a `string` unless the name could not be\n * retrieved, in which case this value will be `null`. On web this value is `null`.\n * - E.g., `\"Expo\"`, `\"Yelp\"`, `\"Instagram\"`\n */\nexport const applicationName: string | null = ExpoApplication\n ? ExpoApplication.applicationName || null\n : null;\n\n// @needsAudit\n/**\n * The ID of the application. On Android, this is the application ID. On iOS, this is the bundle ID.\n * On web, this is `null`.\n * - E.g., `\"com.cocoacasts.scribbles\"`, `\"com.apple.Pages\"`\n */\nexport const applicationId: string | null = ExpoApplication\n ? ExpoApplication.applicationId || null\n : null;\n\n// @needsAudit\n/**\n * **Android only.** The value of [`Settings.Secure.ANDROID_ID`](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID).\n * This is a hexadecimal `string` unique to each combination of app-signing key, user, and device.\n * The value may change if a factory reset is performed on the device or if an APK signing key changes.\n * For more information about how the platform handles `ANDROID_ID` in Android 8.0 (API level 26)\n * and higher, see [Android 8.0 Behavior Changes](https://developer.android.com/about/versions/oreo/android-8.0-changes.html#privacy-all).\n * On iOS and web, this value is `null`.\n * > In versions of the platform lower than Android 8.0 (API level 26), this value remains constant\n * > for the lifetime of the user's device. See the [ANDROID_ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID)\n * > official docs for more information.\n * - E.g., `\"dd96dec43fb81c97\"`\n */\nexport const androidId: string | null = ExpoApplication ? ExpoApplication.androidId || null : null;\n\n// @needsAudit\n/**\n * **Android only.** Gets the referrer URL of the installed app with the [`Install Referrer API`](https://developer.android.com/google/play/installreferrer)\n * from the Google Play Store. In practice, the referrer URL may not be a complete, absolute URL.\n * @return A `Promise` that fulfills with a `string` of the referrer URL of the installed app.\n *\n * @example\n * ```ts\n * await Application.getInstallReferrerAsync();\n * // \"utm_source=google-play&utm_medium=organic\"\n * ```\n */\nexport async function getInstallReferrerAsync(): Promise<string> {\n if (!ExpoApplication.getInstallReferrerAsync) {\n throw new UnavailabilityError('expo-application', 'getInstallReferrerAsync');\n }\n return await ExpoApplication.getInstallReferrerAsync();\n}\n\n// @needsAudit\n/**\n * **iOS only.** Gets the iOS \"identifier for vendor\" ([IDFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor))\n * value, a string ID that uniquely identifies a device to the app’s vendor. This method may\n * sometimes return `nil`, in which case wait and call the method again later. This might happen\n * when the device has been restarted before the user has unlocked the device.\n *\n * The OS will change the vendor identifier if all apps from the current app's vendor have been\n * uninstalled.\n *\n * @return A `Promise` that fulfills with a `string` specifying the app's vendor ID. Apps from the\n * same vendor will return the same ID. See Apple's documentation for more information about the\n * vendor ID's semantics.\n *\n * @example\n * ```ts\n * await Application.getIosIdForVendorAsync();\n * // \"68753A44-4D6F-1226-9C60-0050E4C00067\"\n * ```\n */\nexport async function getIosIdForVendorAsync(): Promise<string | null> {\n if (!ExpoApplication.getIosIdForVendorAsync) {\n throw new UnavailabilityError('expo-application', 'getIosIdForVendorAsync');\n }\n return (await ExpoApplication.getIosIdForVendorAsync()) ?? null;\n}\n\n// @docsMissing\nexport enum ApplicationReleaseType {\n UNKNOWN = 0,\n SIMULATOR = 1,\n ENTERPRISE = 2,\n DEVELOPMENT = 3,\n AD_HOC = 4,\n APP_STORE = 5,\n}\n\n// @needsAudit\n/**\n * **iOS only.** Gets the iOS application release type.\n * @return Returns a promise which fulfills with an [`ApplicationReleaseType`](#applicationreleasetype).\n */\nexport async function getIosApplicationReleaseTypeAsync(): Promise<ApplicationReleaseType> {\n if (!ExpoApplication.getApplicationReleaseTypeAsync) {\n throw new UnavailabilityError('expo-application', 'getApplicationReleaseTypeAsync');\n }\n return await ExpoApplication.getApplicationReleaseTypeAsync();\n}\n\n// @needsAudit\n/**\n * **iOS only.** Gets the current [Apple Push Notification (APN)](https://developer.apple.com/documentation/bundleresources/entitlements/aps-environment?language=objc)\n * service environment.\n * @return Returns a promise fulfilled with the string, either `'development'` or `'production'`,\n * based on the current APN environment.\n */\nexport async function getIosPushNotificationServiceEnvironmentAsync(): Promise<string> {\n if (!ExpoApplication.getPushNotificationServiceEnvironmentAsync) {\n throw new UnavailabilityError('expo-application', 'getPushNotificationServiceEnvironmentAsync');\n }\n return await ExpoApplication.getPushNotificationServiceEnvironmentAsync();\n}\n\n// @needsAudit\n/**\n * Gets the time the app was installed onto the device, not counting subsequent updates. If the app\n * is uninstalled and reinstalled, this method returns the time the app was reinstalled.\n * - On iOS, this method uses the [`NSFileCreationDate`](https://developer.apple.com/documentation/foundation/nsfilecreationdate?language=objc)\n * of the app's document root directory.\n * - On Android, this method uses [`PackageInfo.firstInstallTime`](https://developer.android.com/reference/android/content/pm/PackageInfo.html#firstInstallTime).\n * - On web, this method returns `null`.\n *\n * @return Returns a `Promise` that fulfills with a `Date` object that specifies the time the app\n * was installed on the device.\n *\n * @example\n * ```ts\n * await Application.getInstallationTimeAsync();\n * // 2019-07-18T18:08:26.121Z\n * ```\n */\nexport async function getInstallationTimeAsync(): Promise<Date> {\n if (!ExpoApplication.getInstallationTimeAsync) {\n throw new UnavailabilityError('expo-application', 'getInstallationTimeAsync');\n }\n const installationTime = await ExpoApplication.getInstallationTimeAsync();\n return new Date(installationTime);\n}\n\n// @needsAudit\n/**\n * **Android only.** Gets the last time the app was updated from the Google Play Store.\n * @return Returns a `Promise` that fulfills with a `Date` object that specifies the last time\n * the app was updated via the Google Play Store).\n *\n * @example\n * ```ts\n * await Application.getLastUpdateTimeAsync();\n * // 2019-07-18T21:20:16.887Z\n * ```\n */\nexport async function getLastUpdateTimeAsync(): Promise<Date> {\n if (!ExpoApplication.getLastUpdateTimeAsync) {\n throw new UnavailabilityError('expo-application', 'getLastUpdateTimeAsync');\n }\n const lastUpdateTime = await ExpoApplication.getLastUpdateTimeAsync();\n return new Date(lastUpdateTime);\n}\n"]}
1
+ {"version":3,"file":"Application.js","sourceRoot":"","sources":["../src/Application.ts"],"names":[],"mappings":"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","sourcesContent":["import { UnavailabilityError } from 'expo-modules-core';\n\nimport ExpoApplication from './ExpoApplication';\n\n// @needsAudit\n/**\n * The human-readable version of the native application that may be displayed in the app store.\n * This is the `Info.plist` value for `CFBundleShortVersionString` on iOS and the version name set\n * by `version` in `app.json` on Android at the time the native app was built.\n * On web, this value is `null`.\n * @example `\"2.11.0\"`\n */\nexport const nativeApplicationVersion: string | null = ExpoApplication\n ? ExpoApplication.nativeApplicationVersion || null\n : null;\n\n// @needsAudit\n/**\n * The internal build version of the native application that the app store may use to distinguish\n * between different binaries. This is the `Info.plist` value for `CFBundleVersion` on iOS (set with\n * `ios.buildNumber` value in `app.json` in a standalone app) and the version code set by\n * `android.versionCode` in `app.json` on Android at the time the native app was built. On web, this\n * value is `null`. The return type on Android and iOS is `string`.\n * @example iOS: `\"2.11.0\"`, Android: `\"114\"`\n */\nexport const nativeBuildVersion: string | null = ExpoApplication\n ? ExpoApplication.nativeBuildVersion || null\n : null;\n\n// @needsAudit\n/**\n * The human-readable name of the application that is displayed with the app's icon on the device's\n * home screen or desktop. On Android and iOS, this value is a `string` unless the name could not be\n * retrieved, in which case this value will be `null`. On web this value is `null`.\n * @example `\"Expo\"`, `\"Yelp\"`, `\"Instagram\"`\n */\nexport const applicationName: string | null = ExpoApplication\n ? ExpoApplication.applicationName || null\n : null;\n\n// @needsAudit\n/**\n * The ID of the application. On Android, this is the application ID. On iOS, this is the bundle ID.\n * On web, this is `null`.\n * @example `\"com.cocoacasts.scribbles\"`, `\"com.apple.Pages\"`\n */\nexport const applicationId: string | null = ExpoApplication\n ? ExpoApplication.applicationId || null\n : null;\n\n// @needsAudit\n/**\n * The value of [`Settings.Secure.ANDROID_ID`](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID).\n * This is a hexadecimal `string` unique to each combination of app-signing key, user, and device.\n * The value may change if a factory reset is performed on the device or if an APK signing key changes.\n * For more information about how the platform handles `ANDROID_ID` in Android 8.0 (API level 26)\n * and higher, see [Android 8.0 Behavior Changes](https://developer.android.com/about/versions/oreo/android-8.0-changes.html#privacy-all).\n * On iOS and web, this value is `null`.\n * > In versions of the platform lower than Android 8.0 (API level 26), this value remains constant\n * > for the lifetime of the user's device. See the [ANDROID_ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID)\n * > official docs for more information.\n * @example `\"dd96dec43fb81c97\"`\n * @platform android\n */\nexport const androidId: string | null = ExpoApplication ? ExpoApplication.androidId || null : null;\n\n// @needsAudit\n/**\n * Gets the referrer URL of the installed app with the [`Install Referrer API`](https://developer.android.com/google/play/installreferrer)\n * from the Google Play Store. In practice, the referrer URL may not be a complete, absolute URL.\n * @return A `Promise` that fulfills with a `string` of the referrer URL of the installed app.\n *\n * @example\n * ```ts\n * await Application.getInstallReferrerAsync();\n * // \"utm_source=google-play&utm_medium=organic\"\n * ```\n * @platform android\n */\nexport async function getInstallReferrerAsync(): Promise<string> {\n if (!ExpoApplication.getInstallReferrerAsync) {\n throw new UnavailabilityError('expo-application', 'getInstallReferrerAsync');\n }\n return await ExpoApplication.getInstallReferrerAsync();\n}\n\n// @needsAudit\n/**\n * Gets the iOS \"identifier for vendor\" ([IDFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor))\n * value, a string ID that uniquely identifies a device to the app’s vendor. This method may\n * sometimes return `nil`, in which case wait and call the method again later. This might happen\n * when the device has been restarted before the user has unlocked the device.\n *\n * The OS will change the vendor identifier if all apps from the current app's vendor have been\n * uninstalled.\n *\n * @return A `Promise` that fulfills with a `string` specifying the app's vendor ID. Apps from the\n * same vendor will return the same ID. See Apple's documentation for more information about the\n * vendor ID's semantics.\n *\n * @example\n * ```ts\n * await Application.getIosIdForVendorAsync();\n * // \"68753A44-4D6F-1226-9C60-0050E4C00067\"\n * ```\n * @platform ios\n */\nexport async function getIosIdForVendorAsync(): Promise<string | null> {\n if (!ExpoApplication.getIosIdForVendorAsync) {\n throw new UnavailabilityError('expo-application', 'getIosIdForVendorAsync');\n }\n return (await ExpoApplication.getIosIdForVendorAsync()) ?? null;\n}\n\n// @docsMissing\nexport enum ApplicationReleaseType {\n UNKNOWN = 0,\n SIMULATOR = 1,\n ENTERPRISE = 2,\n DEVELOPMENT = 3,\n AD_HOC = 4,\n APP_STORE = 5,\n}\n\n// @needsAudit\n/**\n * Gets the iOS application release type.\n * @return Returns a promise which fulfills with an [`ApplicationReleaseType`](#applicationreleasetype).\n * @platform ios\n */\nexport async function getIosApplicationReleaseTypeAsync(): Promise<ApplicationReleaseType> {\n if (!ExpoApplication.getApplicationReleaseTypeAsync) {\n throw new UnavailabilityError('expo-application', 'getApplicationReleaseTypeAsync');\n }\n return await ExpoApplication.getApplicationReleaseTypeAsync();\n}\n\n// @needsAudit\n/**\n * Gets the current [Apple Push Notification (APN)](https://developer.apple.com/documentation/bundleresources/entitlements/aps-environment?language=objc)\n * service environment.\n * @return Returns a promise fulfilled with the string, either `'development'` or `'production'`,\n * based on the current APN environment.\n * @platform ios\n */\nexport async function getIosPushNotificationServiceEnvironmentAsync(): Promise<string> {\n if (!ExpoApplication.getPushNotificationServiceEnvironmentAsync) {\n throw new UnavailabilityError('expo-application', 'getPushNotificationServiceEnvironmentAsync');\n }\n return await ExpoApplication.getPushNotificationServiceEnvironmentAsync();\n}\n\n// @needsAudit\n/**\n * Gets the time the app was installed onto the device, not counting subsequent updates. If the app\n * is uninstalled and reinstalled, this method returns the time the app was reinstalled.\n * - On iOS, this method uses the [`NSFileCreationDate`](https://developer.apple.com/documentation/foundation/nsfilecreationdate?language=objc)\n * of the app's document root directory.\n * - On Android, this method uses [`PackageInfo.firstInstallTime`](https://developer.android.com/reference/android/content/pm/PackageInfo.html#firstInstallTime).\n * - On web, this method returns `null`.\n *\n * @return Returns a `Promise` that fulfills with a `Date` object that specifies the time the app\n * was installed on the device.\n *\n * @example\n * ```ts\n * await Application.getInstallationTimeAsync();\n * // 2019-07-18T18:08:26.121Z\n * ```\n */\nexport async function getInstallationTimeAsync(): Promise<Date> {\n if (!ExpoApplication.getInstallationTimeAsync) {\n throw new UnavailabilityError('expo-application', 'getInstallationTimeAsync');\n }\n const installationTime = await ExpoApplication.getInstallationTimeAsync();\n return new Date(installationTime);\n}\n\n// @needsAudit\n/**\n * Gets the last time the app was updated from the Google Play Store.\n * @return Returns a `Promise` that fulfills with a `Date` object that specifies the last time\n * the app was updated via the Google Play Store).\n *\n * @example\n * ```ts\n * await Application.getLastUpdateTimeAsync();\n * // 2019-07-18T21:20:16.887Z\n * ```\n * @platform android\n */\nexport async function getLastUpdateTimeAsync(): Promise<Date> {\n if (!ExpoApplication.getLastUpdateTimeAsync) {\n throw new UnavailabilityError('expo-application', 'getLastUpdateTimeAsync');\n }\n const lastUpdateTime = await ExpoApplication.getLastUpdateTimeAsync();\n return new Date(lastUpdateTime);\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "expo-application",
3
- "version": "4.0.0",
3
+ "version": "4.0.1",
4
4
  "description": "A universal module that gets native application information such as its ID, app name, and build version at runtime",
5
5
  "main": "build/Application.js",
6
6
  "types": "build/Application.d.ts",
@@ -29,8 +29,12 @@
29
29
  "author": "650 Industries, Inc.",
30
30
  "license": "MIT",
31
31
  "homepage": "https://docs.expo.dev/versions/latest/sdk/application/",
32
+ "dependencies": {},
32
33
  "devDependencies": {
33
34
  "expo-module-scripts": "^2.0.0"
34
35
  },
35
- "gitHead": "1fffde73411ee7a642b98f1506a8de921805d52b"
36
+ "peerDependencies": {
37
+ "expo": "*"
38
+ },
39
+ "gitHead": "9faa58818454ba59dbff95077b9025a1c1cbd9fd"
36
40
  }
package/src/Application.ts CHANGED
@@ -8,7 +8,7 @@ import ExpoApplication from './ExpoApplication';
8
8
  * This is the `Info.plist` value for `CFBundleShortVersionString` on iOS and the version name set
9
9
  * by `version` in `app.json` on Android at the time the native app was built.
10
10
  * On web, this value is `null`.
11
- * - E.g., `"2.11.0"`
11
+ * @example `"2.11.0"`
12
12
  */
13
13
  export const nativeApplicationVersion: string | null = ExpoApplication
14
14
  ? ExpoApplication.nativeApplicationVersion || null
@@ -21,7 +21,7 @@ export const nativeApplicationVersion: string | null = ExpoApplication
21
21
  * `ios.buildNumber` value in `app.json` in a standalone app) and the version code set by
22
22
  * `android.versionCode` in `app.json` on Android at the time the native app was built. On web, this
23
23
  * value is `null`. The return type on Android and iOS is `string`.
24
- * - E.g., iOS: `"2.11.0"`, Android: `"114"`
24
+ * @example iOS: `"2.11.0"`, Android: `"114"`
25
25
  */
26
26
  export const nativeBuildVersion: string | null = ExpoApplication
27
27
  ? ExpoApplication.nativeBuildVersion || null
@@ -32,7 +32,7 @@ export const nativeBuildVersion: string | null = ExpoApplication
32
32
  * The human-readable name of the application that is displayed with the app's icon on the device's
33
33
  * home screen or desktop. On Android and iOS, this value is a `string` unless the name could not be
34
34
  * retrieved, in which case this value will be `null`. On web this value is `null`.
35
- * - E.g., `"Expo"`, `"Yelp"`, `"Instagram"`
35
+ * @example `"Expo"`, `"Yelp"`, `"Instagram"`
36
36
  */
37
37
  export const applicationName: string | null = ExpoApplication
38
38
  ? ExpoApplication.applicationName || null
@@ -42,7 +42,7 @@ export const applicationName: string | null = ExpoApplication
42
42
  /**
43
43
  * The ID of the application. On Android, this is the application ID. On iOS, this is the bundle ID.
44
44
  * On web, this is `null`.
45
- * - E.g., `"com.cocoacasts.scribbles"`, `"com.apple.Pages"`
45
+ * @example `"com.cocoacasts.scribbles"`, `"com.apple.Pages"`
46
46
  */
47
47
  export const applicationId: string | null = ExpoApplication
48
48
  ? ExpoApplication.applicationId || null
@@ -50,7 +50,7 @@ export const applicationId: string | null = ExpoApplication
50
50
 
51
51
  // @needsAudit
52
52
  /**
53
- * **Android only.** The value of [`Settings.Secure.ANDROID_ID`](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID).
53
+ * The value of [`Settings.Secure.ANDROID_ID`](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID).
54
54
  * This is a hexadecimal `string` unique to each combination of app-signing key, user, and device.
55
55
  * The value may change if a factory reset is performed on the device or if an APK signing key changes.
56
56
  * For more information about how the platform handles `ANDROID_ID` in Android 8.0 (API level 26)
@@ -59,13 +59,14 @@ export const applicationId: string | null = ExpoApplication
59
59
  * > In versions of the platform lower than Android 8.0 (API level 26), this value remains constant
60
60
  * > for the lifetime of the user's device. See the [ANDROID_ID](https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID)
61
61
  * > official docs for more information.
62
- * - E.g., `"dd96dec43fb81c97"`
62
+ * @example `"dd96dec43fb81c97"`
63
+ * @platform android
63
64
  */
64
65
  export const androidId: string | null = ExpoApplication ? ExpoApplication.androidId || null : null;
65
66
 
66
67
  // @needsAudit
67
68
  /**
68
- * **Android only.** Gets the referrer URL of the installed app with the [`Install Referrer API`](https://developer.android.com/google/play/installreferrer)
69
+ * Gets the referrer URL of the installed app with the [`Install Referrer API`](https://developer.android.com/google/play/installreferrer)
69
70
  * from the Google Play Store. In practice, the referrer URL may not be a complete, absolute URL.
70
71
  * @return A `Promise` that fulfills with a `string` of the referrer URL of the installed app.
71
72
  *
@@ -74,6 +75,7 @@ export const androidId: string | null = ExpoApplication ? ExpoApplication.androi
74
75
  * await Application.getInstallReferrerAsync();
75
76
  * // "utm_source=google-play&utm_medium=organic"
76
77
  * ```
78
+ * @platform android
77
79
  */
78
80
  export async function getInstallReferrerAsync(): Promise<string> {
79
81
  if (!ExpoApplication.getInstallReferrerAsync) {
@@ -84,7 +86,7 @@ export async function getInstallReferrerAsync(): Promise<string> {
84
86
 
85
87
  // @needsAudit
86
88
  /**
87
- * **iOS only.** Gets the iOS "identifier for vendor" ([IDFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor))
89
+ * Gets the iOS "identifier for vendor" ([IDFV](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor))
88
90
  * value, a string ID that uniquely identifies a device to the app’s vendor. This method may
89
91
  * sometimes return `nil`, in which case wait and call the method again later. This might happen
90
92
  * when the device has been restarted before the user has unlocked the device.
@@ -101,6 +103,7 @@ export async function getInstallReferrerAsync(): Promise<string> {
101
103
  * await Application.getIosIdForVendorAsync();
102
104
  * // "68753A44-4D6F-1226-9C60-0050E4C00067"
103
105
  * ```
106
+ * @platform ios
104
107
  */
105
108
  export async function getIosIdForVendorAsync(): Promise<string | null> {
106
109
  if (!ExpoApplication.getIosIdForVendorAsync) {
@@ -121,8 +124,9 @@ export enum ApplicationReleaseType {
121
124
 
122
125
  // @needsAudit
123
126
  /**
124
- * **iOS only.** Gets the iOS application release type.
127
+ * Gets the iOS application release type.
125
128
  * @return Returns a promise which fulfills with an [`ApplicationReleaseType`](#applicationreleasetype).
129
+ * @platform ios
126
130
  */
127
131
  export async function getIosApplicationReleaseTypeAsync(): Promise<ApplicationReleaseType> {
128
132
  if (!ExpoApplication.getApplicationReleaseTypeAsync) {
@@ -133,10 +137,11 @@ export async function getIosApplicationReleaseTypeAsync(): Promise<ApplicationRe
133
137
 
134
138
  // @needsAudit
135
139
  /**
136
- * **iOS only.** Gets the current [Apple Push Notification (APN)](https://developer.apple.com/documentation/bundleresources/entitlements/aps-environment?language=objc)
140
+ * Gets the current [Apple Push Notification (APN)](https://developer.apple.com/documentation/bundleresources/entitlements/aps-environment?language=objc)
137
141
  * service environment.
138
142
  * @return Returns a promise fulfilled with the string, either `'development'` or `'production'`,
139
143
  * based on the current APN environment.
144
+ * @platform ios
140
145
  */
141
146
  export async function getIosPushNotificationServiceEnvironmentAsync(): Promise<string> {
142
147
  if (!ExpoApplication.getPushNotificationServiceEnvironmentAsync) {
@@ -173,7 +178,7 @@ export async function getInstallationTimeAsync(): Promise<Date> {
173
178
 
174
179
  // @needsAudit
175
180
  /**
176
- * **Android only.** Gets the last time the app was updated from the Google Play Store.
181
+ * Gets the last time the app was updated from the Google Play Store.
177
182
  * @return Returns a `Promise` that fulfills with a `Date` object that specifies the last time
178
183
  * the app was updated via the Google Play Store).
179
184
  *
@@ -182,6 +187,7 @@ export async function getInstallationTimeAsync(): Promise<Date> {
182
187
  * await Application.getLastUpdateTimeAsync();
183
188
  * // 2019-07-18T21:20:16.887Z
184
189
  * ```
190
+ * @platform android
185
191
  */
186
192
  export async function getLastUpdateTimeAsync(): Promise<Date> {
187
193
  if (!ExpoApplication.getLastUpdateTimeAsync) {