You must develop on a Mac.
- Target Android devices running Lollipop (5.0) or newer
- Use Xcode 13.1 or higher
- Target iOS devices running 13 or newer
- Target iPadOS devices running 13.1 or newer
Once you’ve downloaded your
tar file from the releases page, run either:
tar -xvf mxmobile-ios.tar.gz
tar -xvf mxmobile-android.tar.gz
Your tar file should uncompress the gzipped tarball and create a folder in the same directory with the name
mxmobile-android folder, then:
- Install Homebrew. Run
brew updateto make sure you have the most recent version.
- Install these packages:
brew install imagemagick
brew install cmake
- Install RVM.
- Install ruby:
rvm install ruby-2.7.0.
- (Optional) Create the mxmobile gemset:
cd .By default, RubyGems are stored in a system location. If you have multiple projects that use RubyGems, the gems may conflict with each other. RVM lets you create a separate folder called a gemset. It then sets up your environment such that the bundler will install the gems into the gemset so that different gemsets don’t conflict with each other nor with the system gems.
- Install python3 (3.7.3):
brew install python3.
- Install pip (which isn’t automatically installed when installing python through Homebrew).
- Install conan (1.16.1):
pip3 install conan.
Now, contact MX to obtain an Artifactory email and password.
Once you’ve received your Artifactory email and password, create a text file in the root of your mxmobile-android or mxmobile-ios directory called
artifactory.txt and add the artifactory credentials MX provided:
1 2 EMAIL=<artifactory_email_from_mx> PASSWORD=<artifactory_password_from_mx>
If Building on Android
- Open Android Studio.
- Select File > Open….
- Open the
- Wait for gradle to finish syncing the project, then build.
If Building on iOS
- Run build MXmobile iOS scheme onto a test device or Simulator.
If you encounter an issue while using the SDK, please report the bug in the following way:
- In your mobile app, select the floating dev tools widget. Then, select the bug icon.
- Fill out the form.
- Press Send.
The MXmobile SDK provides many important files that you can edit to change your mobile app’s visuals and functionality.
For a complete list of important files, please visit the files overview in the reference.
Customize the App
Now that you’ve installed the MXmobile SDK, it is yours to control. We recommend you start making the app your own by adding your custom assets.