jiti-meet/doc/mobile.md

2.8 KiB

Jitsi Meet mobile apps

Jitsi Meet can also be built as a standalone mobile application for iOS and Android. It uses the React Native framework.

First make sure the React Native dependencies are installed.

NOTE: This document assumes the app is being built on a macOS system.

NOTE: The app must be built for an actual device since the simulators don't work properly with the native plugins we require.

iOS

  1. Install some extra dependencies
  • Install ios-deploy globally (in case you want to use the React Native CLI to deploy the app to the device)

    npm install -g ios-deploy
    

    You may need to add --unsafe-perm=true if you are running on Mac OS 10.11 or greater.

  1. Build the app

    There are 2 ways to build the app: using the CLI or using Xcode.

    Using the CLI:

    react-native run-ios --device
    

    When the app is launched from the CLI the output can be checked with the following command:

    react-native log-ios
    

    Using Xcode

    • Open ios/jitsi-meet-react.xcworkspace in Xcode. Make sure it's the workspace file!

    • Select your device from the top bar and hit the "play" button.

    When the app is launched from Xcode the Debug console will show the output logs the application creates.

  2. Other remarks

    It's likely you'll need to change the bundle ID for deploying to a device because the default bundle ID points to the application signed by Atlassian.

    This can be changed in the "General" tab. Under "Identity" set "Bundle Identifier" to a different value, and adjust the "Team" in the "Signing" section to match your own.

Android

The React Native dependencies page has very detailed information on how to setup Android Studio and the required components for getting the necessary build environment. Make sure you follow it closely.

  1. Building the app

    The app can be built using the CLI utility as follows:

    react-native run-android
    

    It will be launched on the connected Android device.

Debugging

The official documentation on debugging is quite extensive, it is the preferred method for debugging.

NOTE: When using Chrome Developer Tools for debugging the JavaScript code is being interpreted by Chrome's V8 engine, instead of JSCore which React Native uses. It's important to keep this in mind due to potential differences in supported JavaScript features.