react-native-daily-js-playground

A simple app showcasing react-native-daily-js, the Daily library for React Native.

Usage

General React Native setup

In the React Native development environment setup page, select "React Native CLI Quickstart" and follow the instructions under the heading "Installing dependencies".

The instructions vary depending on your development OS (macOS, Windows, Linux) and target OS (iOS, Android), so be sure to follow the steps for each closely.

Note: You will need Xcode (i.e. a Mac) for iOS development.

Building

cd DailyPlayground

# Use the version of node specified in .nvmrc
nvm i

# Unfortunate one-time thing, necessary for building from Xcode: make this node
# version the default, so build phases use the right version
nvm alias default $(node --version)

npm i

# Generate ios/DailyPlayground.xcworkspace
# IMPORTANT: make sure you have the right version of Cocoapods installed for this project. See Podfile.lock for version.
npx pod-install

Running the React Native dev server

cd DailyPlayground

# Bundle JS, start JS file server, and start watching for file changes in order
# to re-bundle
npm start -- --reset-cache

Leave this terminal tab open and running.

Running on iOS

First, you'll need to do a one-time setup. This is required to build to device.

If you're familiar with Xcode, you'll need to open DailyPlayground.xcworkspace and, in the DailyPlayground target settings, provide a development team registered with Apple.

If you're newer to Xcode, here are some more detailed instructions to get you started.

First, open the project in Xcode. Make sure to specifically select DailyPlayground.xcworkspace from /DailyPlayground/ios. This is also a good time to plug in your device to be sure the following steps are successful.

From the main menu, select Preferences and then Accounts. Click the + sign to add an account (e.g. an Apple ID).

Once an is account added, close Preferences and select the folder icon in the top left corner. Then select DailyPlayground from the side panel and navigate to Signing & Capabilities in the top nav bar. Open the "Team" dropdown and select the account added in the previous step. The "Signing Certificate" section should update accordingly with your account information.

Once your settings have been updated, select your device from the device dropdown. Simply hit Run (or the Play icon) and you're ready to go!

Note: The app should work as long as you're on the same WiFi as your dev box running the React Native development server.

iOS debugging tips:

If you see the error Change your bundle identifier to a unique string to try again update the "Bundle Identifier" input in Signing & Capabilities to make it unique. This should clear the error.
If you see an error that says Xcode was unable to launch because it has an invalid code signature, inadequate entitlements or its profile has not been explicitly trusted by the user you may need to update the settings on your iPhone device to enable the required permissions. Open Settings on your iPhone, select General, then Device Management, and click Trust for DailyPlayground.
You may also be prompted to enter you login keychain password. Be sure to click Always trust to avoid the prompt showing multiple times.

Running on Android

After plugging in an Android device configured for debugging, simply run:

npm run android

Room configuration

To keep things simple, a one-time, temporary Daily room is used. To use one of your own rooms, update the object returned in /DailyPlayground/api.ts.

async function createRoom(): Promise<{ url: string }> {
  let response = await fetch(newRoomEndpoint),
    room = await response.json();
  return room;

  // Comment out the above and uncomment the below, using your own URL
  // return { url: "https://your-domain.daily.co/hello" };
}

As a reminder, you can create and configure rooms through your Daily dashboard or through calls to the Daily REST API.

Interactive debugging

Ever since the introduction of synchronous methods to react-native-webrtc, the common approach of using the Chrome dev tools for interactive debugging sadly will not work.

Fear not! You can still do interactive debugging. How to do so will depend on the device you're debugging on as well as whether or not you're using the Hermes JavaScript engine:

On Android, you must enable Hermes to debug interactively. Once you've done so, you'll be able to debug using the Chrome inspector.
On iOS, you can debug with or without Hermes. If you're not using Hermes, you can debug using the Safari dev tools. If you are using Hermes, you can debug using the Chrome inspector.
Starting with React Native 0.70, Hermes is already enabled by default for both iOS and Android, so unless you have disabled it, you should be good to go.

To give yourself access to helpful globals from the console, uncomment the following block in App.tsx:

/**
 * Uncomment to set up debugging globals.
 */
useEffect(() => {
  const g = global as any;
  g.Daily = Daily;
  g.callObject = callObject;
}, [callObject]);

React Native Debugger

If you're looking to inspect specific components, update styles, or inspect network calls, React Native Debugger can also be helpful for debugging.

bgdv-ateliers / react-native-daily-js-playground Goto Github PK