@config-plugins/ffmpeg-kit-react-native
v8.0.0
Published
Config plugin to auto configure FFMPEG on prebuild
Downloads
7,324
Maintainers
Readme
config-plugins/ffmpeg-kit-react-native
Config plugin to auto-configure ffmpeg-kit-react-native
when the native code is generated (npx expo prebuild
).
Versioning
| expo
| ffmpeg-kit-react-native
| @config-plugins/ffmpeg-kit-react-native
|
| ------ | ------------------------- | ----------------------------------------- |
| 51.0.0 | 6.0.2 | ^8.0.0 |
| 50.0.0 | 6.0.2 | ^7.0.0 |
| 49.0.0 | 5.1.0 | ^6.0.0 |
| 48.0.0 | 5.1.0 | ^5.0.0 |
| 47.0.0 | 5.1.0 | ^4.0.0 |
| 46.0.0 | 4.5.2 | ^3.0.0 |
| 45.0.0 | 4.5.1 | ^2.0.0 |
Expo installation
Tested against Expo SDK 50. Most packages worked on iOS. Not all packages have been tested on Android.
This package cannot be used in the "Expo Go" app because it requires custom native code.
First install the package with yarn, npm, or npx expo install
.
npx expo install ffmpeg-kit-react-native @config-plugins/ffmpeg-kit-react-native
After installing this npm package, add the config plugin to the plugins
array of your app.json
or app.config.js
:
{
"expo": {
"plugins": ["@config-plugins/ffmpeg-kit-react-native"]
}
}
Next, rebuild your app as described in the "Adding custom native code" guide.
API
The plugin provides props for extra customization. Every time you change the props or plugins, you'll need to rebuild (and prebuild
) the native app. If no extra properties are added, defaults will be used.
package
(string): Package to use. Options are:min
,min-gpl
,https
,https-gpl
,audio
,video
,full
,full-gpl
. Learn more.ios.package
(string): Specify an iOS-only package.android.package
(string): Specify an Android-only package.
Example
{
"plugins": [
[
"@config-plugins/ffmpeg-kit-react-native",
{
"package": "min",
"ios": {
"package": "video"
}
}
]
]
}
Important Notes
- This plugin changes the minimum deployment target on Android to
24
(from21
) which may break other packages in your app! - Changing the "package" field on iOS will require re-running
pod install
after updating withnpx expo prebuild -p ios --no-install
. - Most of the modifications in this plugin are dangerous meaning it's highly likely that something may break over time. The plugin is heavily unit-tested to attempt to prevent breaking.