Skip to content

Latest commit

 

History

History
99 lines (60 loc) · 4.13 KB

README.md

File metadata and controls

99 lines (60 loc) · 4.13 KB
Raw

daily-expo-demo

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

Usage

Expo requirements

This project cannot be used with an Expo Go app because it requires custom native code.

When a project requires custom native code or a config plugin, we need to transition from using Expo Go to a development build.

More details about the custom native code used by this demo can be found in rn-daily-js-expo-config-plugin.

Building remotely

If you do not have experience with Xcode and Android Studio builds or do not have them installed locally on your computer, you will need to follow this guide from Expo to use EAS Build.

Building locally

You will need to have installed locally on your computer:

Install the demo dependencies

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

# Install dependencies
npm i

# Before a native app can be compiled, the native source code must be generated.
npx expo prebuild

Running on Android

After plugging in an Android device configured for debugging, run the following command:

npm run android

Running on iOS

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

If you're familiar with Xcode, open ios/dailyexpodemo.xcworkspace and, in the 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 dailyexpodemo.xcworkspace from /ios. The /ios directory will have been generated by running npx expo prebuild as instructed above. This is also a good time to plug in your iOS device to be sure the following steps are successful.

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

xcode-accounts.png

Once an account is added, perform the following steps:

  1. Close Settings.
  2. Select the folder icon in the top left corner.
  3. Select dailyexpodemo from the side panel
  4. Navigate to Signing & Capabilities in the top nav bar.
  5. Open the "Team" dropdown
  6. Select the account added in the previous step.

The "Signing Certificate" section should update accordingly with your account information.

xcode-signing.png

Troubleshooting common errors:

  • 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 resolve 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 to enable the required permissions as follows:

  1. Open Settings on your iPhone
  2. Select General, then Device Management
  3. 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.

After, run the following command:

npm run ios

Room configuration

You will need to create a public Daily room in order to use this app.

You can create and configure rooms through your Daily dashboard, or through the Daily REST API.