Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

react-native-copy-asset

ridvanaltun1.8kISC3.0.2

Linking and unlinking of assets in your react-native app, works for fonts and sounds

react-native, react, native, js, asset, assets, link

readme

react-native-copy-asset

npm version CircleCI

Advantages

  • react-native link only supports font files, this tool supports all assets.
  • Unlinking is automatic when you delete an asset, with react-native link, you need to unlink the files manually.
  • Proper link (and unlink) for mp3 (to use with react-native-sound) and ttf files.

Check out this starter-kit to use your assets with even more simplicity.

Usage

  • Install
    npm install -g react-native-copy-asset
    # or yarn
    yarn global add react-native-copy-asset
  • Add assets to your react-native.config.js as you would with react-native link
    ...
     "assets": [
        "./src/font",
        "./src/mp3"
      ]
  • Run the command and linking + unlinking is automatic!
    react-native-copy-asset

Explanation

With react-native link you have to unlink the files manually, which is hard work.
Instead this library writes link-assets-manifest.json to the root of android and ios folders to keep track of the files which it added, for later removing it for you if missing from your assets!

Parameters

  • -p, --path - path to project, defaults to cwd.
  • -a, --assets - assets paths, for example react-native-copy-asset -a ./src/font ./src/mp3.
  • -ios-a, --ios-assets - ios assets paths, will disable android linking
  • -android-a, --android-assets - android assets paths, will disable ios linking.
  • -n-u, --no-unlink - Not to unlink assets which not longer exists, not recommanded.