Merge pull request #437 from microsoft/saraclay-patch-1
Update README.md
This commit is contained in:
Sara
GitHub
Коммит
8bf71f65b5
|
|
@ -2,8 +2,6 @@
|
|||
|
||||
This sample showcases a Digital Sign UWP running on Windows IoT Core. Here we will demonstrate how the app receives content in different multimedia forms - e.g. video, audio, image, slideshow - from an XML file stored online and displays this content to the user. The digital sign in this sample is interactive and allows web browsing as well as allowing for touch input.
|
||||
|
||||
This is a headed sample. To better understand what headed mode is and how to configure your device to be headed, follow the instructions [here](/Docs/HeadlessMode).
|
||||
|
||||
### Prerequisites
|
||||
|
||||
* Device running Windows IoT Core build 10240 or greater.
|
||||
|
|
@ -18,7 +16,7 @@ You can find the source code for this sample by downloading a zip of all of our
|
|||
|
||||
Make a copy of the DigitalSignageUAP folder on your disk and open the project from Visual Studio.
|
||||
|
||||
Make sure you set the 'Remote Debugging' setting to point to your Windows IoT device. Go back to the basic 'Hello World' [sample](/Samples/HelloWorld) if you need guidance.
|
||||
Make sure you set the 'Remote Debugging' setting to point to your Windows IoT device.
|
||||
|
||||
## Deploy your app
|
||||
|
||||
|
|
@ -26,7 +24,7 @@ If you're building for Minnowboard Max, select `x86` in the architecture dropdow
|
|||
|
||||
When everything is set up, you should be able to press F5 from Visual Studio. The Digital Signage app will deploy and start on the Windows IoT device, and you should see the main view page as displayed below:
|
||||
|
||||
<img src="../../../Resources/images/DigitalSignage/DigitalSignage1.png" height="400">
|
||||
|
||||
|
||||
### Slideshow
|
||||
|
||||
|
|
@ -34,11 +32,11 @@ The app's slideshow can be likened to a screensaver which displays while the app
|
|||
|
||||
1. From the Main page, click (or tap, if your monitor is touch-enabled) "Play Slideshow".
|
||||
|
||||
<img src="../../../Resources/images/DigitalSignage/DigitalSign_slideshow.png" height="400">
|
||||
|
||||
|
||||
2. Slideshow begins - various content is displayed, including ads and screensaver visuals with audio.
|
||||
|
||||
<img src="../../../Resources/images/DigitalSignage/DigitalSign_horses.png" height="400">
|
||||
|
||||
|
||||
3. End the slideshow by either a) moving your mouse, b) pressing any key or c) tap anywhere on the screen. The main page will return to the screen.
|
||||
|
||||
|
|
@ -46,7 +44,7 @@ The app's slideshow can be likened to a screensaver which displays while the app
|
|||
|
||||
1. From the Main page, click (or tap, if your monitor is touch-enabled) "Internet Explorer".
|
||||
|
||||
<img src="../../../Resources/images/DigitalSignage/DigitalSign_web.png" height="400">
|
||||
|
||||
|
||||
2. Tap or click the Address Bar at the top of the page.
|
||||
|
||||
|
|
@ -54,15 +52,15 @@ The app's slideshow can be likened to a screensaver which displays while the app
|
|||
|
||||
When using the on-screen keyboard, you may click characters with your mouse or tap to type if your monitor is touch-enabled.
|
||||
|
||||
<img src="../../../Resources/images/DigitalSignage/DigitalSign_keyboard2.png" height="400">
|
||||
|
||||
|
||||
4. Click or tap the "Go" button. This navigates the browser to the Microsoft home page
|
||||
|
||||
<img src="../../../Resources/images/DigitalSignage/DigitalSign_microsoft.png" height="400">
|
||||
|
||||
|
||||
5. Navigate to other pages in the browser or return to the main screen by tapping or clicking the "Home" icon on the screen
|
||||
|
||||
<img src="../../../Resources/images/DigitalSignage/DigitalSign_home.png" height="400">
|
||||
|
||||
|
||||
## Exploring the Code
|
||||
|
||||
|
|
@ -188,9 +186,8 @@ In the DisplayNext() method, we traverse through our list of media files obtaine
|
|||
|
||||
1. From the Main page, click (or tap, if your monitor is touch-enabled) "Settings".
|
||||
|
||||
<img src="../../../Resources/images/DigitalSignage/DigitalSign_settings.png" height="400">
|
||||
|
||||
|
||||
2. Using the physical keyboard or touch screen, you may specify a new config file to read from at the location you specify.
|
||||
|
||||
<img src="../../../Resources/images/DigitalSignage/DigitalSign_settings1.png" height="400">
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -34,7 +34,7 @@ If you're building for Minnowboard Max, select `x86` in the architecture dropdow
|
|||
|
||||
When everything is set up, you should be able to press F5 from Visual Studio. The Digital Signage app will deploy and start on the Windows IoT device, and you should see the main view page as displayed below:
|
||||
|
||||
<img src="../../Resources/images/DigitalSignage/DigitalSignage1.png" height="400">
|
||||
|
||||
|
||||
### Slideshow
|
||||
|
||||
|
|
@ -42,11 +42,11 @@ The app's slideshow can be likened to a screensaver which displays while the app
|
|||
|
||||
1. From the Main page, click (or tap, if your monitor is touch-enabled) "Play Slideshow".
|
||||
|
||||
<img src="../../Resources/images/DigitalSignage/DigitalSign_slideshow.png" height="400">
|
||||
|
||||
|
||||
2. Slideshow begins - various content is displayed, including ads and screensaver visuals with audio.
|
||||
|
||||
<img src="../../Resources/images/DigitalSignage/DigitalSign_horses.png" height="400">
|
||||
|
||||
|
||||
3. End the slideshow by either a) moving your mouse, b) pressing any key or c) tap anywhere on the screen. The main page will return to the screen.
|
||||
|
||||
|
|
@ -54,7 +54,7 @@ The app's slideshow can be likened to a screensaver which displays while the app
|
|||
|
||||
1. From the Main page, click (or tap, if your monitor is touch-enabled) "Internet Explorer".
|
||||
|
||||
<img src="../../Resources/images/DigitalSignage/DigitalSign_web.png" height="400">
|
||||
|
||||
|
||||
2. Tap or click the Address Bar at the top of the page.
|
||||
|
||||
|
|
@ -62,15 +62,15 @@ The app's slideshow can be likened to a screensaver which displays while the app
|
|||
|
||||
When using the on-screen keyboard, you may click characters with your mouse or tap to type if your monitor is touch-enabled.
|
||||
|
||||
<img src="../../Resources/images/DigitalSignage/DigitalSign_keyboard2.png" height="400">
|
||||
|
||||
|
||||
4. Click or tap the "Go" button. This navigates the browser to the Microsoft home page
|
||||
|
||||
<img src="../../Resources/images/DigitalSignage/DigitalSign_microsoft.png" height="400">
|
||||
|
||||
|
||||
5. Navigate to other pages in the browser or return to the main screen by tapping or clicking the "Home" icon on the screen
|
||||
|
||||
<img src="../../Resources/images/DigitalSignage/DigitalSign_home.png" height="400">
|
||||
|
||||
|
||||
## Exploring the Code
|
||||
|
||||
|
|
@ -196,9 +196,9 @@ In the DisplayNext() method, we traverse through our list of media files obtaine
|
|||
|
||||
1. From the Main page, click (or tap, if your monitor is touch-enabled) "Settings".
|
||||
|
||||
<img src="../../Resources/images/DigitalSignage/DigitalSign_settings.png" height="400">
|
||||
|
||||
|
||||
2. Using the physical keyboard or touch screen, you may specify a new config file to read from at the location you specify.
|
||||
|
||||
<img src="../../Resources/images/DigitalSignage/DigitalSign_settings1.png" height="400">
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -2,11 +2,11 @@
|
|||
|
||||
We'll learn how to launch an external process (exe) from a Universal Windows Platform (UWP) app using `Windows.System.ProcessLauncher` API.
|
||||
|
||||
This is a headed sample. To better understand what headed mode is and how to configure your device to be headed, follow the instructions [here](/Docs/HeadlessMode).
|
||||
This is a headed sample. To better understand what headed mode is and how to configure your device to be headed, follow the instructions [here](https://docs.microsoft.com/en-us/windows/iot-core/learn-about-hardware/headlessmode).
|
||||
|
||||
### Windows IoT Core Fall Update required
|
||||
|
||||
The `Windows.System.ProcessLauncher` API is new to Windows IoT Core Fall Update. You can download a Windows 10 IoT Core image with Fall Update from our [downloads page](/Downloads).
|
||||
The `Windows.System.ProcessLauncher` API is new to Windows IoT Core Fall Update. You can download a Windows 10 IoT Core image with Fall Update from our [downloads page](https://docs.microsoft.com/en-us/windows/iot-core/downloads).
|
||||
|
||||
### Windows SDK Update required
|
||||
|
||||
|
|
@ -24,19 +24,19 @@ The code for the ProcessLauncher sample can be found under: <samples root folder
|
|||
|
||||
If you're building for Minnowboard Max, select `x86` as the architecture. If you're building for Raspberry Pi 2 or 3 or DragonBoard , select `ARM`.
|
||||
|
||||
Select **Remote Machine** to point to IoT device and hit F5 to deploy to your device. Go back to the basic 'Hello World' [sample](/Samples/HelloWorld) if you need guidance.
|
||||
Select **Remote Machine** to point to IoT device and hit F5 to deploy to your device. Go back to the basic 'Hello World' [sample](https://docs.microsoft.com/en-us/samples/microsoft/windows-iotcore-samples/hello-world/) if you need guidance.
|
||||
|
||||
### Test your app
|
||||
|
||||
The sample app when deployed displays a screen similar to this one:
|
||||
|
||||
|
||||
|
||||
|
||||
Go ahead, click the **Run Command** button to launch the application specified in the **Command** edit box, SampleConsoleApplication.exe, which is an executable Win32 application built and deployed from the sample app as well.
|
||||
|
||||
When run, the SampleConsoleApplication exe, will send output to both the Standard Output and Standard Error boxes. The return error code of the process, 100, should also be shown.
|
||||
|
||||
|
||||
|
||||
|
||||
## Let's take a look at the code
|
||||
|
||||
|
|
@ -50,7 +50,7 @@ Since the IoT extension SDK is not added to projects by default, we'll need to a
|
|||
|
||||
To do so, right-click on the References entry under the project, select "Add Reference" then navigate the resulting dialog to `Universal Windows->Extensions->Windows IoT Extensions for the UWP` making sure the right version, 10.0.10586.0 or higher, is selected, then check the box, and click OK.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Add systemManagement capabiity
|
||||
|
|
@ -159,19 +159,19 @@ int main(int argc, char **argv)
|
|||
}
|
||||
```
|
||||
|
||||
The application has been added to the solution as a *console application*. To create your own console application, please refer to the [Console Application Sample](/Samples/memorystatus).
|
||||
The application has been added to the solution as a *console application*. To create your own console application, please refer to the [Console Application Sample](https://docs.microsoft.com/en-us/samples/microsoft/windows-iotcore-samples/memory-status/).
|
||||
|
||||
To be able to find and invoke the SampleConsoleApplication exe at runtime, we need to package the output exe with the AppX. We've already added it to the sample application. However, to do the same in your own application, you can follow these steps:
|
||||
|
||||
1. Put the output exe in the same folder as the C# sample. Right click on the C++ console app project, select *Properties*, then open the *General* tab
|
||||
1. Change the output directory to the be the same as the C# sample (or a subfolder) and click OK 
|
||||
1. Change the output directory to the be the same as the C# sample (or a subfolder) and click OK 
|
||||
1. Build the console application to create and put the exe in its new location
|
||||
1. Add the exe to the UWP projct: Right click on the Project, select *Add -> Existing Item*
|
||||
1. Browse to and select the exe just built
|
||||
1. After the exe is added to the UWP project, we need to make sure it's added to the AppX package layout, Right click on the exe, select *Properties*
|
||||
1. Change *Build Action* to *Content*
|
||||
1. Change *Copy to Output Directory* to *Always* 
|
||||
1. Finaly, to ensure the exe is built every time the main app is deployed, we need to change the project dependency, Right click the solution, select *Project Dependencies* and make the UWP project have a dependency on the console app 
|
||||
1. Change *Copy to Output Directory* to *Always* 
|
||||
1. Finaly, to ensure the exe is built every time the main app is deployed, we need to change the project dependency, Right click the solution, select *Project Dependencies* and make the UWP project have a dependency on the console app 
|
||||
|
||||
Now, everytime the solution is built or deployed, it'll ensure the console application exe is up-to-date and deployed with the rest of the AppX.
|
||||
|
||||
|
|
@ -189,9 +189,9 @@ To add an exe to the **allow list**, add to or replace the reg value in the reg
|
|||
|
||||
**Note**, `ProcessLauncher` API launches executables under the current user credentials, or **DefautlAccount**, so apps requiring admin priviliges will fail to run properly.
|
||||
|
||||
Go ahead, run the command above on your device, using [SSH](/Docs/SSH){:target="_blank"} or [PowerShell](/Docs/PowerShell){:target="_blank"}. Then, in the sample app (no need to restart) type the command `c:\windows\system32\ipconfig.exe`. You should get an output similar to the one below:
|
||||
Go ahead, run the command above on your device, using [SSH](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/ssh) or [PowerShell](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/powershell). Then, in the sample app (no need to restart) type the command `c:\windows\system32\ipconfig.exe`. You should get an output similar to the one below:
|
||||
|
||||
|
||||
|
||||
|
||||
### Using the Process Launcher Whitelist Configuration Tool
|
||||
|
||||
|
|
@ -201,9 +201,9 @@ The tool is available as part of the *Windows 10 IoT Utilities* on [GitHub](http
|
|||
|
||||
To use the tool:
|
||||
|
||||
* Clone or download a zip of the *Windows 10 IoT Utilities* from [GitHub](https://github.com/ms-iot/iot-utilities)
|
||||
* Open and build the solution under *ProcessLauncherWhitelist*
|
||||
* Copy the executable to your device using [FTP](/docs/ftp)
|
||||
* Run it on the device using [SSH](/Docs/SSH) or [PowerShell](/Docs/PowerShell)
|
||||
* Clone or download a zip of the *Windows 10 IoT Utilities* from [GitHub](https://github.com/ms-iot/iot-utilities).
|
||||
* Open and build the solution under *ProcessLauncherWhitelist*.
|
||||
* Copy the executable to your device using [FTP](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/ftp).
|
||||
* Run it on the device using [SSH](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/ssh) or [PowerShell](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/powershell).
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -12,11 +12,11 @@ description: We'll learn how to launch an external process (exe) from a Universa
|
|||
|
||||
We'll learn how to launch an external process (exe) from a Universal Windows Platform (UWP) app using `Windows.System.ProcessLauncher` API.
|
||||
|
||||
This is a headed sample. To better understand what headed mode is and how to configure your device to be headed, follow the instructions [here](/Docs/HeadlessMode).
|
||||
This is a headed sample. To better understand what headed mode is and how to configure your device to be headed, follow the instructions [here](https://docs.microsoft.com/en-us/windows/iot-core/learn-about-hardware/headlessmode).
|
||||
|
||||
### Windows IoT Core Fall Update required
|
||||
|
||||
The `Windows.System.ProcessLauncher` API is new to Windows IoT Core Fall Update. You can download a Windows 10 IoT Core image with Fall Update from our [downloads page](/Downloads).
|
||||
The `Windows.System.ProcessLauncher` API is new to Windows IoT Core Fall Update. You can download a Windows 10 IoT Core image with Fall Update from our [downloads page](https://docs.microsoft.com/en-us/windows/iot-core/downloads).
|
||||
|
||||
### Windows SDK Update required
|
||||
|
||||
|
|
@ -34,7 +34,7 @@ The code for the ProcessLauncher sample can be found under: <samples root folder
|
|||
|
||||
If you're building for Minnowboard Max, select `x86` as the architecture. If you're building for Raspberry Pi 2 or 3 or DragonBoard , select `ARM`.
|
||||
|
||||
Select **Remote Machine** to point to IoT device and hit F5 to deploy to your device. Go back to the basic 'Hello World' [sample](/Samples/HelloWorld) if you need guidance.
|
||||
Select **Remote Machine** to point to IoT device and hit F5 to deploy to your device. Go back to the basic 'Hello World' [sample](https://docs.microsoft.com/en-us/samples/microsoft/windows-iotcore-samples/hello-world/) if you need guidance.
|
||||
|
||||
### Test your app
|
||||
|
||||
|
|
@ -199,7 +199,7 @@ To add an exe to the **allow list**, add to or replace the reg value in the reg
|
|||
|
||||
**Note**, `ProcessLauncher` API launches executables under the current user credentials, or **DefautlAccount**, so apps requiring admin priviliges will fail to run properly.
|
||||
|
||||
Go ahead, run the command above on your device, using [SSH](/Docs/SSH){:target="_blank"} or [PowerShell](/Docs/PowerShell){:target="_blank"}. Then, in the sample app (no need to restart) type the command `c:\windows\system32\ipconfig.exe`. You should get an output similar to the one below:
|
||||
Go ahead, run the command above on your device, using [SSH](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/ssh)or [PowerShell](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/powershell). Then, in the sample app (no need to restart) type the command `c:\windows\system32\ipconfig.exe`. You should get an output similar to the one below:
|
||||
|
||||
|
||||
|
||||
|
|
@ -207,14 +207,14 @@ Go ahead, run the command above on your device, using [SSH](/Docs/SSH){:target="
|
|||
|
||||
Additionally, to overcome the limitations of using reg commands, the Process Launcher Whitelist Configuration tool can be used to very easily add or remove executables to the ProcessLauncher **allow list**.
|
||||
|
||||
The tool is available as part of the *Windows 10 IoT Utilities* on [GitHub](https://github.com/ms-iot/iot-utilities)..
|
||||
The tool is available as part of the *Windows 10 IoT Utilities* on [GitHub](https://github.com/ms-iot/iot-utilities).
|
||||
|
||||
To use the tool:
|
||||
|
||||
* Clone or download a zip of the *Windows 10 IoT Utilities* from [GitHub](https://github.com/ms-iot/iot-utilities)
|
||||
* Open and build the solution under *ProcessLauncherWhitelist*
|
||||
* Copy the executable to your device using [FTP](/docs/ftp)
|
||||
* Run it on the device using [SSH](/Docs/SSH) or [PowerShell](/Docs/PowerShell)
|
||||
* Clone or download a zip of the *Windows 10 IoT Utilities* from [GitHub](https://github.com/ms-iot/iot-utilities).
|
||||
* Open and build the solution under *ProcessLauncherWhitelist*.
|
||||
* Copy the executable to your device using [FTP](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/ftp).
|
||||
* Run it on the device using [SSH](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/ssh) or [PowerShell](https://docs.microsoft.com/en-us/windows/iot-core/connect-your-device/powershell).
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче