You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: powerapps-docs/mobile/run-powerapps-on-mobile.md
+204Lines changed: 204 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -18,3 +18,207 @@ search.app:
18
18
---
19
19
20
20
# Run canvas apps and model-driven apps on a mobile device
21
+
When you create an app, or someone shares an app with you—either a canvas app or model-driven app—you can run that app on iOS and Android devices by using the Power Apps mobile app. If you're on a Windows device, you can only run canvas apps; model-driven apps aren't supported on the Power Apps mobile app for Windows devices. In this topic, you'll learn how to get started and run a canvas app and a model-driven app on your mobile device.
22
+
23
+
To learn how to use model-driven apps running on the Power Apps mobile app, see [User Guide for model-driven apps running on the Power Apps mobile app](use-custom-model-driven-app-on-mobile.md).
24
+
25
+
> [!IMPORTANT]
26
+
> Customer engagement apps (such as Dynamics 365 Sales and Dynamics 365 Customer Service) don't run in the Power Apps mobile app. Instead, you use the Dynamics 365 for phones and tablets apps. More information: [User Guide for Dynamics 365 for phones and tablets](https://docs.microsoft.com/dynamics365/mobile-app/dynamics-365-phones-tablets-users-guide)
27
+
28
+
![Power Apps mobile user interface.](media/powerappsmobile.png"Power Apps mobile user interface")
29
+
30
+
Legend:
31
+
32
+
1.**Model-driven apps**
33
+
2.**Canvas apps**
34
+
35
+
## Install the Power Apps mobile app
36
+
37
+
To follow this procedure, if you're not signed up for Power Apps, [sign up for free](https://make.powerapps.com/signup?redirect=marketing&email=) before you begin, and then download Power Apps from the [App Store](https://itunes.apple.com/app/powerapps/id1047318566?mt=8) or [Google Play](https://play.google.com/store/apps/details?id=com.microsoft.msapps) onto an iPhone, iPad, or Android device running a [supported operating system](../maker/canvas-apps/limits-and-config.md). Also, make sure you have access to a canvas app that you created or that someone else created and shared with you.
38
+
39
+
40
+
## Open Power Apps, and sign in
41
+
42
+
Open Power Apps on your mobile device, and sign in by using your Azure Active Directory credentials.
43
+
44
+
![Sign in to Power Apps.](media/powerapps_mobile_app_signin_screen.png"Sign in to Power Apps")
45
+
46
+
If you have the Microsoft Authenticator app installed on your mobile device, enter your username when prompted, and then approve the notification sent to your device.
47
+
48
+
49
+
## Find the app
50
+
51
+
When you sign in to the app, the **My apps** filter is set by default. If you don't find the app you're looking for, you can open the **Power Apps** menu, and then select a different filter.
-**All apps**: Displays all canvas apps and model-driven apps to which you have access, including apps you created and apps that others shared with you.
59
+
60
+
-**My apps**: For canvas apps, this displays canvas apps that you've opened, apps that you're the owner of, and apps that you can edit. For model-driven apps, this displays all model-driven apps that you have access to.
61
+
62
+
-**Sample apps** (canvas apps only): Displays sample canvas apps from Microsoft that showcase real application scenarios with fictitious data to help you explore design possibilities.
63
+
64
+
-**Favorites** (canvas apps only): Displays canvas apps that you've marked by selecting the ellipsis (...) on the app tile, and then selecting **Favorite**. To remove an app from this list, select the ellipsis (...) on the app tile, and then select **Unfavorite**.
65
+
66
+
![Mark as Favorite.](media/add_favorite_app.png"Mark as Favorite")
67
+
68
+
-**Featured apps** (canvas apps only): Displays canvas apps that your admin has marked as featured apps.
69
+
70
+
### Sort apps
71
+
72
+
After you filter your apps, you can sort the filtered list by the date the apps were most recently opened or modified, or alphabetically by name. These preferences are retained when you close and reopen apps. You can sort both canvas apps and model-driven apps.
73
+
74
+
![Sort menu.](media/sort_apps.png"Sort menu")
75
+
76
+
### Search apps
77
+
78
+
If you know the name of the app you want to run, you can select the search icon at the top, and then type part of its name in the search box. You can search for both canvas apps and model-driven apps.
79
+
80
+
![Search for apps.](media/search_apps.png"Search for apps")
81
+
82
+
If you filtered your apps, the filtered list will be searched.
83
+
84
+
### Refresh the list of apps
85
+
86
+
Select the refresh icon  to refresh the list of apps. This will refresh the lists of both the canvas apps and model-driven apps.
87
+
88
+
89
+
## Pin to home
90
+
91
+
You can pin both canvas apps and model-driven apps to the home screen of your device for quick access.
92
+
93
+
### Use Safari to pin to home (iOS 13 or earlier)
94
+
95
+
1. Select the ellipsis (...) on the app tile, select **Pin to Home**;
96
+
97
+
> [!div class="mx-imgBorder"]
98
+
> ![Select Pin to Home.](media/pa_mobile_pin_to_home_iphone.png"Select Pin to Home")
99
+
100
+
2. Select ![Pin an app on iPhone button.](media/add-to-home-button.png"Pin an app on iPhone button").
101
+
102
+
> [!div class="mx-imgBorder"]
103
+
> ![Pin an app on iPhone.](media/pin_to_home_1.png"Pin an app on iPhone")
104
+
105
+
3. Scroll down and select **Add to Home Screen**
106
+
107
+
> [!div class="mx-imgBorder"]
108
+
> ![Add to Home Screen.](media/pin_to_home_2.png"Add to Home Screen")
109
+
110
+
4. Select **Add**.
111
+
112
+
> [!div class="mx-imgBorder"]
113
+
> ![Select Add to add to Home screen.](media/pin_to_home_3.png"Select Add to add to Home screen")
114
+
115
+
> [!NOTE]
116
+
> For iOS devices that have multiple browsers installed, use Safari when pinning an app to home.
117
+
118
+
119
+
### Use Siri shortcuts to pin to home (iOS 14 or later)
120
+
121
+
The Power Apps mobile app is now integrated with Siri shortcuts, which gives you the ability to pin to home, launch apps with Siri, and create new workflows. For more information on how shortcuts work on iOS, see [Shortcuts User Guide](https://support.apple.com/guide/shortcuts/welcome/ios). This feature requires Power Apps mobile version 3.20092.x or later.
122
+
123
+
Users on iOS 14 or later can use Siri Shortcuts to pin an app to the home screen. The new experience works for both model-driven and canvas apps. When you add a Siri shortcut, the app is added to the iOS **Shortcuts** app and from there you can add the app to your home screen.
124
+
125
+
126
+
1. To pin an app to the home screen, select the ellipsis (...) on the app tile.
127
+
2. Select **Add shortcut to Siri**.
128
+
129
+
> [!div class="mx-imgBorder"]
130
+
> ![Add shortcut to Siri.](media/add-shortcut.png"Add shortcut to Siri")
131
+
132
+
3. Add a custom phrase to open the app using voice commands and then select **Add to Siri**.
133
+
134
+
> [!div class="mx-imgBorder"]
135
+
>![Select Add to Siri.](media/add-shortcut-1.png"Select Add to Siri")
136
+
137
+
138
+
4. The app is added to the **Shortcuts** app on your mobile device. Open the **Shortcuts** app and select the ellipsis (...) above the app name.
139
+
140
+
> [!div class="mx-imgBorder"]
141
+
> ![Select the ellipsis to add a shortcut.](media/add-short-2.png"Select the ellipsis] to add shortcut")
142
+
143
+
144
+
5. Select **Add to Home Screen**.
145
+
146
+
> [!div class="mx-imgBorder"]
147
+
> ![Select Add to Home Screen.](media/add-to-homescreen.png"Select Add to Home Screen")
148
+
149
+
6. On the upper right corner, select **Add** and then select **Done**.
> ![App shortcut on home screen.](media/add-shortcut-4.png"App shortcut on home screen")
159
+
160
+
161
+
You can customize the shortcut icon but it is limited to the customization options in iOS. For more information, go to [Modify shortcut icons](https://support.apple.com/guide/shortcuts/modify-shortcut-icons-apd5ad5a2128/ios).
162
+
163
+
### Pin to home on Android
164
+
165
+
Select the ellipsis (...) on the app tile, select **Pin to Home**, and then follow the instructions that appear.
166
+
167
+
![Pin an app.](media/pin_to_home.png"Pin an app")
168
+
169
+
## See non-production apps
170
+
171
+
By default, only production model-driven apps are shown in the list of apps.
172
+
173
+
To see model-driven apps from non-production environments, select the **Settings** menu , and then turn on **Show non-production apps**. Follow the instructions that appear.
To run an app on a mobile device, select the app tile. If someone else created an app and shared it with you in an email, you can run the app by selecting the link in the email.
180
+
181
+
### Run a canvas app
182
+
183
+
If this is the first time you're running a canvas app by using the Power Apps mobile app, a screen shows the swipe gestures.
184
+
185
+
#### Close a canvas app
186
+
187
+
Use your finger to swipe from the left edge of the app to the right to close an app. On Android devices, you can also press the Back button and then confirm that you intended to close the app.
188
+
189
+
![Close an app.](media/swipe.gif"Close an app")
190
+
191
+
#### Pinch and zoom in on a canvas app
192
+
193
+
![Pinch to zoom.](media/pinchtozoom.jpg"Pinch to zoom")
194
+
195
+
#### Give consent to a canvas app
196
+
197
+
If an app requires a connection to a data source or permission to use the device's capabilities (such as the camera or ___location services), you must give consent before you can use the app. Typically, you're prompted only the first time you run the app.
198
+
199
+
![Give consent to a canvas app.](media/give_consent_canvas.jpg"Give consent to canvas app")
200
+
201
+
### Run a model-driven app
202
+
203
+
The following image shows an example of a model-driven app screen after you've signed in. To learn how to use model-driven apps running on the Power Apps mobile app, go to [User Guide for model-driven apps running on the Power Apps mobile app](use-custom-model-driven-app-on-mobile.md).
204
+
205
+
![Model-driven app home page.](media/model-driven-app-opened.png"Model-driven app home page")
206
+
207
+
#### Give consent to a model-driven app
208
+
209
+
If an app requires a connection to a data source or permission to use the device's capabilities (such as the camera or ___location services), you must give consent before you can use the app. Typically, you're prompted only the first time you use the app.
0 commit comments