Skip to content

Commit 2029579

Browse files
author
Jonathan Diehl
authored
Update build-native-widget.md
1 parent e156b9d commit 2029579

1 file changed

Lines changed: 18 additions & 26 deletions

File tree

content/en/docs/howto8/extensibility/build-native-widget.md

Lines changed: 18 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,9 @@ Clone this [code sample](https://github.com/mendix/native-group-box-pluggable-wi
3434

3535
Before starting this how-to, make sure you have completed the following prerequisites:
3636

37-
* Install Mendix Studio Pro 8.x.
37+
* Install the latest version of Mendix Studio Pro 8.18.x.
3838
* Install the Mendix Make It Native app for Mendix 8 on a mobile device or an emulator.
39-
* Install [Node.js](https://nodejs.org) v12.0.0 or any higher version.
39+
* Install [Node.js](https://nodejs.org) v16.
4040
* Install the latest [Yeoman](https://yeoman.io/) with the following command:
4141

4242
```shell {linenos=false}
@@ -87,12 +87,12 @@ To scaffold your project folder for the group box widget, follow these steps:
8787
8888
* Widget name: {*GroupBox*}
8989
* Widget description: {*Widget to group building blocks, snippets, or other widgets.*}
90-
* Organization name: {*com.mendix.widget.native*}
91-
* Copyright: {*Mendix 2019*}
90+
* Organization name: {*Your organization*}
91+
* Copyright: {*Your copyright statement*}
9292
* License: {*Apache-2.0*}
9393
* Initial version: {*1.0.0*}
94-
* Author: {*Mendix*}
95-
* Mendix Project path: {*./test/MxTestProject/*}
94+
* Author: {*Your name*}
95+
* Mendix Project path: {*./tests/testProject/*}
9696
* Programming language: {**TypeScript**}
9797
* Widget type: {**For native mobile apps**}
9898
* Widget template: {**Empty widget (recommended for more experienced developers)**}
@@ -112,41 +112,33 @@ In order to test your group box widget, you will a Mendix application that uses
112112
113113
1. Open Studio Pro.
114114
2. Create a new project by clicking **File** > **New Project**.
115-
3. Select the **Blank** app (do not select **Blank App**).
115+
3. Select the **Blank Native Mobile App** (do not select **Blank App**).
116116
4. Click the **Use this starting point** button
117117
5. Fill in the following details in the **App Settings** dialog box:
118118
* App name: *GroupBoxTestProject*
119119
* Enable online services: *No*
120120
6. Click **Create app**.
121121
122-
Optionally, you can remove all unused widgets to optimize the debugging process. To do so, follow these steps:
123-
124-
1. Click **Project** > **Show Project Directory in Explorer**.
125-
2. Open the **widgets** folder.
126-
3. Delete all files in this folder.
127-
128122
Follow these steps to add the Mendix project as a test project to your widget project, so that you can start modeling with the new widget:
129123
130124
1. Close the project in Mendix Studio Pro by clicking **File** > **Close Project**.
131-
2. Move the contents of the Mendix project folder into **test/MxTestProject**, which is located inside your group box widget project folder.
125+
2. Move the contents of the Mendix project folder into **tests/testProject**, which is located inside your group box widget project folder.
132126
133127
Create a test case by following these steps:
134128
135-
1. Open the Mendix test project in **test/MxTestProject** by selecting **File** > **Open Project**.
136-
2. In the **Open App** dialog box, select **Locally on disk**.
137-
3. Open the *GroupBoxTestProject.mpr* file inside your group box widget project folder.
138-
4. Open **Home_Native** page.
139-
5. Copy the **Home** container and paste it underneath that container:
140-
141-
{{< figure src="/attachments/howto8/extensibility/build-native-widget/home-container.png" alt="home container" >}}
142-
143-
6. Delete the contents of your new container.
144-
7. Search in Toolbox for the **Group Box** widget.
145-
8. Drag the widget into your empty container:
129+
1. Build the widget by running `npm run build` in the root folder of the pluggable widget.
130+
2. Open the Mendix test project in **tests/testProject** by selecting **File** > **Open Project**.
131+
3. In the **Open App** dialog box, select **Locally on disk**.
132+
4. Open the *GroupBoxTestProject.mpr* file inside your group box widget project folder.
133+
5. Set the **Security level to Off** in Project Security.
134+
6. Open **Home_Native** page.
135+
7. Delete the Intro screen widget and the two containers holding text from the page.
136+
8. Search in Toolbox for the **Group Box** widget. If you cannot find it press **F4** to refresh the project widgets.
137+
. Drag the widget into the empty container:
146138
147139
{{< figure src="/attachments/howto8/extensibility/build-native-widget/initial-widget.png" alt="initial widget" >}}
148140
149-
9. Double-click the widget, fill in your name as the **Default value**, and click **OK**.
141+
10. Double-click the widget, fill in your name as the **Default value**, and click **OK**.
150142
151143
You have set up your test project. To verify that your Mendix test project is set up correctly, follow these steps:
152144

0 commit comments

Comments
 (0)