We provide a set of scripts to help you run the app for the different platforms that are executed with
To speed up development, only compile and run the apps in the following cases:
npm run <platform>command.
If none of the above cases apply, you could just simply start the React Native packager with
npm start and launch the app you have already deployed to the device or simulator.
The above commands are shortcuts for the
react-native CLI. You can append
-- --help to the above commands to see available options, for example:
$ npm run android -- --help
Make sure you are adding
-- before the options you want to include or run the
react-native CLI directly:
$ npx react-native run-android --help
By default running the app will launch an Android emulator (if you created one) or an iOS simulator, but if you want to test the performance of the app or if you want to make a contribution it is always a good idea to run the app on an actual device.
This will let you ensure that the app is working correctly and in a performant way before submitting a pull request.
To be able to run the app on an Android device you’ll need to follow these steps:
Most Android devices can only install and run apps downloaded from Google Play by default. In order to be able to install the Mattermost Mobile app in the device during development you will need to enable USB Debugging on your device in the Developer options menu by going to Settings > About phone and then tap the Build number row at the bottom seven times, then go back to Settings > Developer options and enable USB debugging.
Plug in your Android device in any available USB port in your development machine (try to avoid hubs and plug it directly into your computer) and check that your device is properly connecting to ADB (Android Debug Bridge) by running
$ adb devices List of devices attached 42006fb3e4fb25b8 device
If you see device in the right column that means that the device is connected. You can have multiple devices attached and the app will be deployed to all of them.
With your device connected to the USB port execute the following in your command prompt to install and launch the app on the device:
$ npm run android
To be able to run the app on an iOS device you’ll need to have Xcode installed on a Mac computer and follow this steps:
The apps that run on an iOS device must be signed. To sign it, you’ll need a set of provisioning profiles. If you already have an Apple Developer account enrolled in the Apple Developer program you can skip this step. If you don’t have an account yet you’ll need to create one and enroll in the Apple Developer Program.
Navigate to the
ios folder in your
mattermost-mobile project, then open the file
Mattermost.xcworkspace in Xcode.
Select the Mattermost project in the Xcode Project Navigator, then select the Mattermost target. Look for the Signing & Capabilities tab.
Repeat the steps for the
NotificationService targets. Each target must use a different Bundle Identifier.
Plug in your iOS device in any available USB port in your development computer.
If everything is set up correctly, your device will be listed as the build target in the Xcode toolbar, and it will also appear in the Devices Pane (⇧⌘2). You can press the Build and run button (⌘R) or select Run from the Product menu to run the app.
As an alternative you can select the targeted device by opening the Product menu in Xcode menu bar, then go to Destination and look for your device to select from the list.
Note: If you run into any issues, please take a look at Apple’s Launching Your App on a Device documentation.
If the app fails to build, you can try the following before trying to build the app again: