Build Using the XDS Dashboard

One option for building your application using XDS is to use the XDS Dashboard. Building the application consists of using the dashboard to declare your project and then initiate the build.

Declare Project

Follow these steps to declare the project:

  1. Open a Web Browser and connect to to the XDS Dashboard.

The URL you use depends of your configuration (e.g. http://localhost:8800).

  1. Open the right sidebar and select the Projects entry to open the project page. Once the page is open, declare a new project by clicking on the "plus" icon next to "Add Project":

{:: style="margin:auto; display:flex"}

When you declare the project, XDS creates the xds-project.conf configuration file if one does not already exist. You should examine this configuration file before you build the project to be sure all configurations are correct for your project.

The configuration file can be very useful when you plan to use XDS client tools such as xds-cli or xds-gdb.

  1. Set Sharing Type appropriately depending on your Client Part configuration:

{:: style="width:90%; max-width:560px; margin:auto; display:flex"}

NOTES:

  • When Path mapping type is selected, you must clone your project into $HOME/xds-workspace directory, which is named Local Path in the modal window.

  • If XDS server is running in the XDS docker container the Server Path must be set to /home/devel/xds-workspace/<xxx> where <xxx> is your project directory name. See the "Installation based on Docker container)" section for more information.

  • If you select Cloud Sync, you can clone your project wherever you want on your local disk.

Build the Application

Building the application requires opening the build page's "build entry" in the left navigational pane, selecting both the project and the SDK, and then initiating the build.

NOTE:

To use the helloworld-native-application example, you need to provide some configuration items. Specifically, you must pass values for both the RSYNC_TARGET and RSYNC_PREFIX environment variables. To pass these variables, use the Settings window in the Build tab. You can use the Env variables field to pass a list of environment variables that are set on the server prior to the build occurring. You must separate individual variables using the semi-colon character:

RSYNC_TARGET=root@<mytarget>;RSYNC_PREFIX=/opt

When you pass these variables, substitute <mytarget> with the valid target IP address or DNS name entry.

Follow these steps to build the application:

  1. Open the build page build entry in the left-hand navigation pane:

{:: style="display:inline; padding:0;"},

  1. Select your Project.

  2. Seclect the Cross SDK you want to use.

  3. Click the Clean / Pre-Build / Build / Populate buttons to execute the build action you want.

{:: style="width:90%; max-width:600px; margin:auto; display:flex"}