bitmovin-player-react-native 1.0.0-alpha.3 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [1.0.0] - 2025-08-04
+
+### Breaking Change
+
+- Introduction of Expo SDK support. Upgrading requires following the [Migration Guide](https://developer.bitmovin.com/playback/docs/react-native-migrating-to-v1).
+
+### Added
+
+- React Native New Architecture Support
+- Expo Config Plugin to manage native configuration from `app.config.ts`.
+- Automatic configuration for Google Cast, Offline, Picture-in-Picture, AirPlay, and Background Playback through Expo plugin.
+
+### Changed
+
+- Minimum iOS/tvOS version is now 15.1+ (was 14.0+).
+- Minimum Android SDK version is now 24 (was 21).
+- Native setup is now automated through Expo SDK - manual configuration is no longer required for v1.0.0+.
+
 ## [0.44.0] - 2025-07-25
 
 ### Changed

package/android/gradle.properties

@@ -1,7 +1,7 @@
 android.useAndroidX=true
 # Also update example/android/gradle.properties and integration_test/android/gradle.properties when updating kotlin version.
 BitmovinPlayerReactNative_kotlinVersion=1.9.21
-BitmovinPlayerReactNative_minSdkVersion=21
+BitmovinPlayerReactNative_minSdkVersion=24
 BitmovinPlayerReactNative_targetSdkVersion=35
 BitmovinPlayerReactNative_compileSdkVersion=35
 BitmovinPlayerReactNative_buildToolsVersion=34.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitmovin-player-react-native",
-  "version": "1.0.0-alpha.3",
+  "version": "1.0.0",
   "description": "Official React Native bindings for Bitmovin's mobile Player SDKs.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -32,7 +32,7 @@
     "brew": "[ \"$(uname)\" != Darwin ] || brew bundle install",
     "docs": "typedoc",
     "pods": "yarn example pods #&& yarn integration-test pods",
-    "bootstrap": "yarn brew && yarn build && yarn example bootstrap && yarn integration-test bootstrap && yarn setup-hooks",
+    "bootstrap": "yarn install && yarn brew && yarn build && yarn example bootstrap && yarn integration-test bootstrap && yarn setup-hooks",
     "integration-test": "yarn --cwd integration_test"
   },
   "keywords": [

package/plugin/build/{FeatureFlags.d.ts → Features.d.ts}

@@ -1,4 +1,4 @@
-export default interface FeatureFlags {
+export default interface Features {
     airPlay?: boolean;
     backgroundPlayback?: boolean;
     googleCastSDK?: {

package/plugin/build/index.d.ts

@@ -1,7 +1,7 @@
-import FeatureFlags from './FeatureFlags';
-export { FeatureFlags };
+import Features from './Features';
+export { Features as FeatureFlags };
 declare const _default: import("expo/config-plugins").ConfigPlugin<{
     playerLicenseKey: string;
-    featureFlags: FeatureFlags;
+    featureFlags: Features;
 }>;
 export default _default;

package/plugin/build/withBitmovinAndroidConfig.d.ts

@@ -1,7 +1,7 @@
 import { ConfigPlugin } from 'expo/config-plugins';
-import FeatureFlags from './FeatureFlags';
+import Features from './Features';
 declare const withBitmovinAndroidConfig: ConfigPlugin<{
     playerLicenseKey: string;
-    features: FeatureFlags;
+    features: Features;
 }>;
 export default withBitmovinAndroidConfig;

package/plugin/build/withBitmovinConfig.d.ts

@@ -1,7 +1,35 @@
 import { ConfigPlugin } from 'expo/config-plugins';
-import FeatureFlags from './FeatureFlags';
+import Features from './Features';
+/**
+ * Expo Config Plugin for Bitmovin Player.
+ * This plugin configures the Bitmovin Player for both iOS and Android platforms.
+ * It accepts a player license key and feature flags to customize the player's behavior.
+ * @param config - The Expo config object.
+ * @param options - An object containing the player license key and feature flags.
+ * @returns The modified Expo config object with Bitmovin Player configurations.
+ *
+ * @example
+ * // app.config.js
+ * module.exports = {
+ *   plugins: [
+ *     [
+ *       'bitmovin-player-react-native',
+ *       {
+ *         playerLicenseKey: 'YOUR_BITMOVIN_PLAYER_LICENSE_KEY',
+ *         featureFlags: {
+ *           airPlay: true,
+ *           backgroundPlayback: true,
+ *           googleCastSDK: { android: '21.3.0', ios: '4.8.1.2' },
+ *           offline: true,
+ *           pictureInPicture: true,
+ *         },
+ *       },
+ *     ]
+ *   ]
+ * };
+ */
 declare const withBitmovinConfig: ConfigPlugin<{
     playerLicenseKey: string;
-    featureFlags: FeatureFlags;
+    featureFlags: Features;
 }>;
 export default withBitmovinConfig;

package/plugin/build/withBitmovinConfig.js

@@ -12,6 +12,34 @@ const defaultFeatureFlags = {
     offline: false,
     pictureInPicture: false,
 };
+/**
+ * Expo Config Plugin for Bitmovin Player.
+ * This plugin configures the Bitmovin Player for both iOS and Android platforms.
+ * It accepts a player license key and feature flags to customize the player's behavior.
+ * @param config - The Expo config object.
+ * @param options - An object containing the player license key and feature flags.
+ * @returns The modified Expo config object with Bitmovin Player configurations.
+ *
+ * @example
+ * // app.config.js
+ * module.exports = {
+ *   plugins: [
+ *     [
+ *       'bitmovin-player-react-native',
+ *       {
+ *         playerLicenseKey: 'YOUR_BITMOVIN_PLAYER_LICENSE_KEY',
+ *         featureFlags: {
+ *           airPlay: true,
+ *           backgroundPlayback: true,
+ *           googleCastSDK: { android: '21.3.0', ios: '4.8.1.2' },
+ *           offline: true,
+ *           pictureInPicture: true,
+ *         },
+ *       },
+ *     ]
+ *   ]
+ * };
+ */
 const withBitmovinConfig = (config, { playerLicenseKey, featureFlags }) => {
     const features = { ...defaultFeatureFlags, ...(featureFlags || {}) };
     config = (0, withBitmovinIosConfig_1.default)(config, { playerLicenseKey, features });

package/plugin/build/withBitmovinIosConfig.d.ts

@@ -1,7 +1,7 @@
 import { ConfigPlugin } from 'expo/config-plugins';
-import FeatureFlags from './FeatureFlags';
+import Features from './Features';
 declare const withBitmovinIosConfig: ConfigPlugin<{
     playerLicenseKey: string;
-    features: FeatureFlags;
+    features: Features;
 }>;
 export default withBitmovinIosConfig;

package/plugin/src/{FeatureFlags.ts → Features.ts}

@@ -1,4 +1,4 @@
-export default interface FeatureFlags {
+export default interface Features {
   airPlay?: boolean;
   backgroundPlayback?: boolean;
   googleCastSDK?: {

package/plugin/src/index.ts

@@ -1,9 +1,9 @@
 import { createRunOncePlugin } from 'expo/config-plugins';
 import withBitmovinConfig from './withBitmovinConfig';
-import FeatureFlags from './FeatureFlags';
+import Features from './Features';
 
 // Keeping the name, and version in sync with it's package.
 const pkg = require('../../package.json');
 
-export { FeatureFlags };
+export { Features as FeatureFlags };
 export default createRunOncePlugin(withBitmovinConfig, pkg.name, pkg.version);

package/plugin/src/withBitmovinAndroidConfig.ts

@@ -4,14 +4,14 @@ import {
   withAndroidManifest,
   withGradleProperties,
 } from 'expo/config-plugins';
-import FeatureFlags from './FeatureFlags';
+import Features from './Features';
 import withAppGradleDependencies from './withAppGradleDependencies';
 
 type ManifestActivity = AndroidConfig.Manifest.ManifestActivity;
 
 const withBitmovinAndroidConfig: ConfigPlugin<{
   playerLicenseKey: string;
-  features: FeatureFlags;
+  features: Features;
 }> = (config, { playerLicenseKey, features }) => {
   const offlineFeatureConfig =
     typeof features.offline === 'object'

package/plugin/src/withBitmovinConfig.ts

@@ -1,9 +1,9 @@
 import { ConfigPlugin } from 'expo/config-plugins';
 import withBitmovinIosConfig from './withBitmovinIosConfig';
-import FeatureFlags from './FeatureFlags';
+import Features from './Features';
 import withBitmovinAndroidConfig from './withBitmovinAndroidConfig';
 
-const defaultFeatureFlags: FeatureFlags = {
+const defaultFeatureFlags: Features = {
   airPlay: false,
   backgroundPlayback: false,
   googleCastSDK: undefined,
@@ -11,9 +11,37 @@ const defaultFeatureFlags: FeatureFlags = {
   pictureInPicture: false,
 };
 
+/**
+ * Expo Config Plugin for Bitmovin Player.
+ * This plugin configures the Bitmovin Player for both iOS and Android platforms.
+ * It accepts a player license key and feature flags to customize the player's behavior.
+ * @param config - The Expo config object.
+ * @param options - An object containing the player license key and feature flags.
+ * @returns The modified Expo config object with Bitmovin Player configurations.
+ * 
+ * @example
+ * // app.config.js
+ * module.exports = {
+ *   plugins: [
+ *     [
+ *       'bitmovin-player-react-native',
+ *       {
+ *         playerLicenseKey: 'YOUR_BITMOVIN_PLAYER_LICENSE_KEY',
+ *         featureFlags: {
+ *           airPlay: true,
+ *           backgroundPlayback: true,
+ *           googleCastSDK: { android: '21.3.0', ios: '4.8.1.2' },
+ *           offline: true,
+ *           pictureInPicture: true,
+ *         },
+ *       },
+ *     ]
+ *   ]
+ * };
+ */
 const withBitmovinConfig: ConfigPlugin<{
   playerLicenseKey: string;
-  featureFlags: FeatureFlags;
+  featureFlags: Features;
 }> = (config, { playerLicenseKey, featureFlags }) => {
   const features = { ...defaultFeatureFlags, ...(featureFlags || {}) };
   config = withBitmovinIosConfig(config, { playerLicenseKey, features });

package/plugin/src/withBitmovinIosConfig.ts

@@ -3,13 +3,13 @@ import {
   withInfoPlist,
   withPodfileProperties,
 } from 'expo/config-plugins';
-import FeatureFlags from './FeatureFlags';
+import Features from './Features';
 
 const isTV = !!process.env.EXPO_TV;
 
 const withBitmovinIosConfig: ConfigPlugin<{
   playerLicenseKey: string;
-  features: FeatureFlags;
+  features: Features;
 }> = (config, { playerLicenseKey, features }) => {
   const offlineFeatureConfig =
     typeof features.offline === 'object'

package/plugin/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/FeatureFlags.ts","./src/index.ts","./src/withAppGradleDependencies.ts","./src/withBitmovinAndroidConfig.ts","./src/withBitmovinConfig.ts","./src/withBitmovinIosConfig.ts"],"version":"5.8.3"}
+{"root":["./src/Features.ts","./src/index.ts","./src/withAppGradleDependencies.ts","./src/withBitmovinAndroidConfig.ts","./src/withBitmovinConfig.ts","./src/withBitmovinIosConfig.ts"],"version":"5.8.3"}