Linking native libraries in React Native

Introduction

Linking native libraries lets your React Native app use features from native code. This helps you add special functions that JavaScript alone can't do.

You want to use a device feature like the camera or GPS that needs native code.

You want to add a third-party library that includes native code.

You need better performance for some parts of your app using native modules.

You want to use native UI components not available in React Native by default.

Syntax

React Native

npx react-native link <library-name>

This command connects the native code of the library to your app automatically.

For React Native 0.60 and above, auto-linking usually works without this command.

Examples

This links the react-native-vector-icons library so you can use custom icons in your app.

React Native

npx react-native link react-native-vector-icons

This links the react-native-maps library to show native map views.

React Native

npx react-native link react-native-maps

Sample App

This simple app shows how to use a native library for icons after linking it. The star icon is from the native react-native-vector-icons library.

React Native

import React from 'react';
import { View, Text } from 'react-native';
import Icon from 'react-native-vector-icons/FontAwesome';

export default function App() {
  return (
    <View style={{flex:1, justifyContent:'center', alignItems:'center'}}>
      <Text>Here is a star icon:</Text>
      <Icon name="star" size={50} color="gold" />
    </View>
  );
}

Important Notes

From React Native 0.60+, most libraries support auto-linking, so manual linking is often not needed.

If auto-linking fails, use npx react-native link to connect native code.

After linking, you may need to rebuild your app to see changes.

Summary

Linking connects native code libraries to your React Native app.

Use npx react-native link for manual linking if auto-linking does not work.

Linking lets you use device features and native UI components.

Practice

1. What is the main purpose of linking native libraries in a React Native app?

easy

A. To connect native code libraries so the app can use device features

B. To write JavaScript code faster

C. To create animations in React Native

D. To debug JavaScript errors

Solution

1. Step 1: Understand linking in React Native

   Linking connects native code libraries to your React Native app so it can access device features like camera or GPS.

2. Step 2: Identify the main purpose

   Since linking allows the app to use native device features, this is its main purpose.

3. Final Answer:

   To connect native code libraries so the app can use device features -> Option A

4. Quick Check:

   Linking = Connect native libraries [OK]

Hint: Linking connects native code to app features [OK]

Common Mistakes:

• Thinking linking is for writing JavaScript faster
• Confusing linking with animation creation
• Assuming linking is for debugging only

2. Which command is used to manually link native libraries in React Native if auto-linking fails?

easy

A. react-native start

B. npm install react-native-link

C. npx react-native link

D. expo install

Solution

1. Step 1: Recall the manual linking command

   The command to manually link native libraries is npx react-native link.

2. Step 2: Compare options

   Only npx react-native link matches the correct manual linking command.

3. Final Answer:

   npx react-native link -> Option C

4. Quick Check:

   Manual linking command = npx react-native link [OK]

Hint: Use 'npx react-native link' for manual linking [OK]

Common Mistakes:

• Using npm install react-native-link instead
• Confusing with react-native start command
• Using expo install which is unrelated

3. Given this React Native code snippet:

import { NativeModules } from 'react-native';

const { MyNativeModule } = NativeModules;

MyNativeModule.doSomething();

What must be true for MyNativeModule to work correctly?

medium

A. The JavaScript code must be minified

B. The app must use Expo managed workflow

C. The app must run only on iOS

D. The native library must be linked to the app

Solution

1. Step 1: Understand native module usage

   Using NativeModules requires the native library to be linked so React Native can access native code.

2. Step 2: Eliminate incorrect options

   Minifying JavaScript, running only on iOS, or using Expo managed workflow are unrelated to linking native modules.

3. Final Answer:

   The native library must be linked to the app -> Option D

4. Quick Check:

   NativeModules need linking [OK]

Hint: NativeModules require linked native libraries [OK]

Common Mistakes:

• Thinking minification affects native linking
• Assuming native modules work only on iOS
• Confusing Expo managed workflow with native linking

4. You ran npx react-native link but your app crashes when using a native library. What is a likely cause?

medium

A. You did not install Node.js

B. You forgot to rebuild the app after linking

C. You used the wrong JavaScript import syntax

D. You are running the app on a simulator

Solution

1. Step 1: Understand linking effects

   After linking native libraries, you must rebuild the app so native code changes take effect.

2. Step 2: Identify the cause of crash

   If the app crashes, it is often because the native code was not compiled into the app yet due to missing rebuild.

3. Final Answer:

   You forgot to rebuild the app after linking -> Option B

4. Quick Check:

   Linking needs rebuild to apply [OK]

Hint: Always rebuild app after linking native libraries [OK]

Common Mistakes:

• Ignoring the rebuild step after linking
• Blaming JavaScript import syntax for native crashes
• Assuming Node.js installation affects linking
• Thinking simulator causes linking crashes

5. You want to use a native camera library in your React Native app. After installing it, auto-linking does not work. What is the best approach to fix this?

hard

A. Run npx react-native link and then rebuild the app

B. Delete the node_modules folder and reinstall packages

C. Only restart the Metro bundler without rebuilding

D. Switch to Expo managed workflow

Solution

1. Step 1: Identify the problem with auto-linking

   If auto-linking fails, manual linking using npx react-native link is the recommended fix.

2. Step 2: Complete the fix by rebuilding

   After linking, rebuilding the app is necessary to apply native code changes.

3. Final Answer:

   Run npx react-native link and then rebuild the app -> Option A

4. Quick Check:

   Manual link + rebuild fixes auto-link fail [OK]

Hint: Manual link and rebuild if auto-link fails [OK]

Common Mistakes:

• Only reinstalling node_modules without linking
• Restarting Metro bundler without rebuild
• Switching to Expo without solving linking