Skip to content

Commit 3f6d049

Browse files
ConnorLandConnorLand
committed
Merge branch 'pr/10308' into development
2 parents 42fdf68 + fb2cda1 commit 3f6d049

File tree

6 files changed

+46
-177
lines changed

6 files changed

+46
-177
lines changed

‎content/en/docs/refguide/mobile/distributing-mobile-apps/building-native-apps/how-to-devapps.md‎

Lines changed: 23 additions & 88 deletions
Original file line numberDiff line numberDiff line change
@@ -18,111 +18,46 @@ A custom developer app helps you by serving as a replacement for the Make It Nat
1818
* Complete [Get Started with Native Mobile](/refguide/mobile/getting-started-with-mobile/)
1919
* Complete the Mendix Native Mobile Builder wizard as found in [Build a Mendix Native App Locally](/refguide/mobile/distributing-mobile-apps/building-native-apps/native-build-locally-manually/)
2020

21-
## Building Your Developer App {#build-your-developer-app}
21+
{{% alert color="info" %}}
22+
Even custom developer apps on iOS must be provisioned and signed. However, we do not recommended you use the same provisioning method as your release build.
2223

23-
1. Run Mendix Native Mobile Builder from your app:
24+
Instead, use an ad-hoc provisioning profile, which allows you to register your testers' devices with Apple and distribute the app outside the App Store. For more information on ad-hoc provisioning, see [Apple's documentation](https://developer.apple.com/help/account/provisioning-profiles/create-an-ad-hoc-provisioning-profile/).
25+
{{% /alert %}}
2426

25-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/start-nbui.png" alt="Start Mendix Native Mobiler Builder" width="350" class="no-border" >}}
2627

27-
1. When Mendix Native Mobile launches you are greeted with the home screen:
28+
## Building Your Developer App with Bitrise {#build-your-developer-app}
2829

29-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/home-screen.png" alt="Mendix Natve Mobile Builder Home Screen" width="350" class="no-border" >}}
30-
31-
1. Choose *Build app for local development*
32-
33-
1. Given you already went through the initial wizard at least once, you should be greeted with the configuration screen for *Building an app for local development*:
34-
35-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/build-custom-dev-app.png" alt="Mendix Natve Mobile Builder Home Screen" width="350" class="no-border" >}}
36-
37-
1. Click the *Build developer app* button
38-
39-
1. The tool will set up your GitHub repository commit your changes, one for iOS and one for Android and continue with building the apps.
40-
41-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/build-release-app-build-step1.png" alt="Building" width="350" class="no-border" >}}{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/build-release-app-build-step1.png" alt="Building" width="350" class="no-border" >}}
42-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/build-release-app-build-step2.png" alt="Build release app" width="350" class="no-border" >}}
43-
44-
1. When the build completes, you can scan the QR code provided to install the app to your device. Currently the QR code service is only supported for Android devices.
45-
46-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/build-release-app-build-done-both.png" alt="Build release app" width="350" class="no-border" >}}
47-
48-
## Installing Your Custom Developer App manually
30+
When using Bitrise to build your native mobile app in the cloud, you can configure the settings below to generate a custom developer app instead of a release app. Once configured, the app can be built and installed similarly to a release version.
4931

5032
### Android
5133

52-
For Android the output of the build is an *APK* file. *APK* files can be directly installed on devices or emulators.
53-
54-
#### Installing on an Emulator
55-
56-
With your emulator running, install your app in your emulator by doing the following:
57-
58-
1. Drag the *APK* onto the emulator's window.
59-
2. Wait for the installation to be done.
60-
3. Open the app from the launcher.
61-
62-
#### Installing on a Device
34+
1. Open the **Android Build** workflow step.
35+
1. Set the **Variant** to `devDebug`:
6336

64-
There are various ways install an app on a device. Installing using a USB is detailed below, but you can use a different method if it suits you. Do the following to install your *APK* onto a device:
65-
66-
1. Connect your device to your machine via USB.
67-
2. Enable file transfer on your device (differs per device).
68-
3. Open **This PC** in File Explorer; your device should be listed as an external device.
69-
4. Drag your *APK* onto your device.
70-
5. Wait for it to finish transferring.
71-
6. Open your device's file manager.
72-
7. Navigate to the root of the file system.
73-
8. Tap the *APK* to install.
74-
9. Go through the installation steps.
75-
10. Open the app from the launcher.
37+
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-bitrise-android.png" alt="Screenshot of the Bitrise dialog to enable a custom developer app">}}
7638

7739
### iOS
7840

79-
By default your custom developer app will be unsigned. To get a signed *IPA*, follow the steps in [Distributing Native Apps](/refguide/mobile/distributing-mobile-apps/distributing-native-apps/). Your custom developer app branch is named **developer**.
80-
81-
The unsigned output of an iOS build is an *XCArchive* file. *XCArchive* files require manual signing before they are ready to be installed on a device.
82-
83-
The signed output of iOS build is an *IPA* file. If correctly signed, *IPA* files can be installed on physical devices.
84-
85-
#### Installing on an Emulator
86-
87-
Before installing, make sure you have completed the following prerequisites:
88-
89-
* Have a Mac OSX machine
90-
* Install LTS builds of Node.js and NPM (download [here](https://nodejs.org/en/))
91-
* Install Cocoapods ([installation instructions](https://cocoapods.org/#install))
92-
* Install the latest Xcode version
41+
1. Open the **Xcode Archive & Export for iOS** workflow step.
42+
1. Set the **Scheme** to `Dev`:
9343

94-
Builds with the Mendix Native Mobile Builder are stripped of simulator artifacts. Therefore, to run on Xcode's Simulator you will have to build the developer branch locally from source by completing these steps:
44+
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-bitrise-xcode.png" alt="Screenshot of the Bitrise dialog to enable a custom developer app">}}
9545

96-
1. Navigate to your GitHub repo.
97-
2. Switch to your **developer** branch:
46+
## Building Your Developer App Locally
9847

99-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/github-branch-switching.png" alt="Switch branch on GitHub" width="350" class="no-border" >}}
100-
101-
3. Click **Clone or Download** and then click **Download ZIP**:
48+
If you are building your release app locally using Android Studio or Xcode, you can adjust the configuration settings below to generate a custom developer build instead of a release build. Once configured, the app can be built and installed similarly to a release version, including on the Android Emulator and iOS Simulator.
10249

103-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/github-download-branch.png" alt="Download repository" width="350" class="no-border" >}}
104-
105-
4. Unzip the downloaded archive.
106-
5. Open a terminal and change directory into the folder.
107-
6. Run this command:
108-
109-
```shell
110-
npm i && cd ios && pod install
111-
```
112-
113-
This will install the node module dependencies and the iOS Dependencies
114-
7. In the **ios** folder, open the **NativeTemplate.xcworkspace** file:
115-
116-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/ios-folder.png" alt="iOS folder structure" class="no-border" >}}
117-
118-
8. In Xcode select the **Dev** target and the emulator you want to build your developer app for:
50+
### Android
11951

120-
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/xcode-target-selection.png" alt="Dev target selection" class="no-border" >}}
52+
1. Open the Android project within your native template in **Android Studio**.
53+
1. Open the **Build Variants** (**View** > **Tool Windows** > **Build Variants**).
54+
1. Set the **Active Build Variant** of the Module **:app** to `devDebug`:
12155

122-
9. Click **Play**.
56+
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-android.png" alt="Screenshot of the Bitrise dialog to enable a custom developer app">}}
12357

124-
#### Distributing the Custom Developer App to the Apple App Store
58+
## iOS
12559

126-
To run your custom developer app on a device which is not registered as a test device on the Apple Mendix Portal, you will have to sign the developer app with your certificates manually and distribute it via TestFlight.
60+
1. Open the iOS project within your native template in **XCode**.
61+
1. Set the Target to `Dev`:
12762

128-
Read more on TestFlight in the [official documentation](https://testflight.apple.com/).
63+
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-xcode.png" alt="Screenshot of the Bitrise dialog to enable a custom developer app">}}

‎content/en/docs/refguide10/mobile/distributing-mobile-apps/building-native-apps/how-to-devapps.md‎

Lines changed: 23 additions & 89 deletions
Original file line numberDiff line numberDiff line change
@@ -18,111 +18,45 @@ A custom developer app helps you by serving as a replacement for the Make It Nat
1818
* Complete [Get Started with Native Mobile](/refguide10/mobile/getting-started-with-mobile/)
1919
* Complete the Mendix Native Mobile Builder wizard as found in [Build a Mendix Native App Locally](/refguide10/mobile/distributing-mobile-apps/building-native-apps/native-build-locally-manually/)
2020

21-
## Building Your Developer App {#build-your-developer-app}
21+
{{% alert color="info" %}}
22+
Even custom developer apps on iOS must be provisioned and signed. However, we do not recommended you use the same provisioning method as your release build.
2223

23-
1. Run Mendix Native Mobile Builder from your app:
24+
Instead, use an ad-hoc provisioning profile, which allows you to register your testers' devices with Apple and distribute the app outside the App Store. For more information on ad-hoc provisioning, see [Apple's documentation](https://developer.apple.com/help/account/provisioning-profiles/create-an-ad-hoc-provisioning-profile/).
25+
{{% /alert %}}
2426

25-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/start-nbui.png" alt="Start Mendix Native Mobiler Builder" width="350" class="no-border" >}}
27+
## Building Your Developer App with Bitrise {#build-your-developer-app}
2628

27-
1. When Mendix Native Mobile launches you are greeted with the home screen:
28-
29-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/home-screen.png" alt="Mendix Natve Mobile Builder Home Screen" width="350" class="no-border" >}}
30-
31-
1. Choose *Build app for local development*
32-
33-
1. Given you already went through the initial wizard at least once, you should be greeted with the configuration screen for *Building an app for local development*:
34-
35-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/build-custom-dev-app.png" alt="Mendix Natve Mobile Builder Home Screen" width="350" class="no-border" >}}
36-
37-
1. Click the *Build developer app* button
38-
39-
1. The tool will set up your GitHub repository, commit your changes, and continue with building the apps:
40-
41-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/build-release-app-build-step1.png" alt="Building" width="350" class="no-border" >}}{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/build-release-app-build-step1.png" alt="Building" width="350" class="no-border" >}}
42-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/build-release-app-build-step2.png" alt="Build release app" width="350" class="no-border" >}}
43-
44-
1. When the build completes, you can scan the QR code provided to install the app to your device. Currently the QR code service is only supported for Android devices.
45-
46-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/build-release-app-build-done-both.png" alt="Build release app" width="350" class="no-border" >}}
47-
48-
## Installing Your Custom Developer App manually
29+
When using Bitrise to build your native mobile app in the cloud, you can configure the settings below to generate a custom developer app instead of a release app. Once configured, the app can be built and installed similarly to a release version.
4930

5031
### Android
5132

52-
For Android the output of the build is an *APK* file. *APK* files can be directly installed on devices or emulators.
53-
54-
#### Installing on an Emulator
55-
56-
With your emulator running, install your app in your emulator by doing the following:
57-
58-
1. Drag the *APK* onto the emulator's window.
59-
2. Wait for the installation to be done.
60-
3. Open the app from the launcher.
33+
1. Open the **Android Build** workflow step.
34+
1. Set the **Variant** to `devDebug`:
6135

62-
#### Installing on a Device
63-
64-
There are various ways install an app on a device. Installing using a USB is detailed below, but you can use a different method if it suits you. Do the following to install your *APK* onto a device:
65-
66-
1. Connect your device to your machine via USB.
67-
2. Enable file transfer on your device (differs per device).
68-
3. Open **This PC** in File Explorer; your device should be listed as an external device.
69-
4. Drag your *APK* onto your device.
70-
5. Wait for it to finish transferring.
71-
6. Open your device's file manager.
72-
7. Navigate to the root of the file system.
73-
8. Tap the *APK* to install.
74-
9. Go through the installation steps.
75-
10. Open the app from the launcher.
36+
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-bitrise-android.png" alt="Screenshot of the Bitrise dialog to enable a custom developer app">}}
7637

7738
### iOS
7839

79-
By default your custom developer app will be unsigned. To get a signed *IPA*, follow the steps in [Distributing Native Apps](/refguide10/mobile/distributing-mobile-apps/distributing-native-apps/). Your custom developer app branch is named **developer**.
80-
81-
The unsigned output of an iOS build is an *XCArchive* file. *XCArchive* files require manual signing before they are ready to be installed on a device.
82-
83-
The signed output of iOS build is an *IPA* file. If correctly signed, *IPA* files can be installed on physical devices.
84-
85-
#### Installing on an Emulator
86-
87-
Before installing, make sure you have completed the following prerequisites:
88-
89-
* Have a Mac OSX machine
90-
* Install LTS builds of Node.js and NPM (download [here](https://nodejs.org/en/))
91-
* Install Cocoapods ([installation instructions](https://cocoapods.org/#install))
92-
* Install the latest Xcode version
40+
1. Open the **Xcode Archive & Export for iOS** workflow step.
41+
1. Set the **Scheme** to `Dev`:
9342

94-
Builds with the Mendix Native Mobile Builder are stripped of simulator artifacts. Therefore, to run on Xcode's Simulator you will have to build the developer branch locally from source by completing these steps:
43+
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-bitrise-xcode.png" alt="Screenshot of the Bitrise dialog to enable a custom developer app">}}
9544

96-
1. Navigate to your GitHub repo.
97-
2. Switch to your **developer** branch:
45+
## Building Your Developer App Locally
9846

99-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/github-branch-switching.png" alt="Switch branch on GitHub" width="350" class="no-border" >}}
100-
101-
3. Click **Clone or Download** and then click **Download ZIP**:
47+
If you are building your release app locally using Android Studio or Xcode, you can adjust the configuration settings below to generate a custom developer build instead of a release build. Once configured, the app can be built and installed similarly to a release version, including on the Android Emulator and iOS Simulator.
10248

103-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/github-download-branch.png" alt="Download repository" width="350" class="no-border" >}}
104-
105-
4. Unzip the downloaded archive.
106-
5. Open a terminal and change directory into the folder.
107-
6. Run this command:
108-
109-
```shell
110-
npm i && cd ios && pod install
111-
```
112-
113-
This will install the node module dependencies and the iOS Dependencies
114-
7. In the **ios** folder, open the **NativeTemplate.xcworkspace** file:
115-
116-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/ios-folder.png" alt="iOS folder structure" class="no-border" >}}
117-
118-
8. In Xcode select the **Dev** target and the emulator you want to build your developer app for:
49+
### Android
11950

120-
{{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/xcode-target-selection.png" alt="Dev target selection" class="no-border" >}}
51+
1. Open the Android project within your native template in **Android Studio**.
52+
1. Open the **Build Variants** (**View** > **Tool Windows** > **Build Variants**).
53+
1. Set the **Active Build Variant** of the Module **:app** to `devDebug`:
12154

122-
9. Click **Play**.
55+
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-android.png" alt="Screenshot of the Bitrise dialog to enable a custom developer app">}}
12356

124-
#### Distributing the Custom Developer App to the Apple App Store
57+
## iOS
12558

126-
To run your custom developer app on a device which is not registered as a test device on the Apple Mendix Portal, you will have to sign the developer app with your certificates manually and distribute it via TestFlight.
59+
1. Open the iOS project within your native template in **XCode**.
60+
1. Set the Target to `Dev`:
12761

128-
Read more on TestFlight in the [official documentation](https://testflight.apple.com/).
62+
{{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-xcode.png" alt="Screenshot of the Bitrise dialog to enable a custom developer app">}}

‎static/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-android.png‎

10.8 KB
Loading

‎static/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-bitrise-android.png‎

68.3 KB
Loading

‎static/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-bitrise-xcode.png‎

46.1 KB
Loading

‎static/attachments/howto/mobile/native-mobile/distribution/build-native-apps/how-to-devapps/custom-developer-app-xcode.png‎

7.52 KB
Loading

0 commit comments

Comments
 (0)