Build your first configuration

This tutorial demonstrates how to create and run a basic ArcGIS Pro solution configuration.

With the ArcGIS Pro SDK for .NET, you can extend ArcGIS Pro with your own unique tools and workflows. Using Microsoft Visual Studio and the Pro SDK, developers can build Pro add-ins and solution configurations that provide users with custom functionality specific to their organization or industry.

Like add-ins, solution configurations also provide developers the ability to customize the startup UI for ArcGIS Pro, with configurations such as a custom splash screen, start page, about page, and conditional logic and user roles that tailor the overall end user experience.

In this tutorial, you will use C# to create a new configuration with the project template, customize the splash screen and start page, and start ArcGIS Pro using a new configuration shortcut.



Create a new ArcGIS Pro Add-In Visual Studio Project

  1. Start Visual Studio.

  2. Choose File > New > Project and then from the ArcGIS templates group, select ArcGIS Pro Managed Configuration. Give your project a name, such as MyManagedConfiguration.

  3. Compile and build the project without starting ArcGIS Pro by selecting Build > Build Solution.

  4. From Windows Explorer, navigate to C:\Users\<UserName>\Documents\ArcGIS\AddIns\ArcGISPro\Configurations. You should see your newly compiled configuration file reflecting the name of your project with the .proConfigX extension.

  5. Confirm that the start action and command line arguments for the project have been correctly set.

    • In the Solution Explorer, right-click the project and choose Properties at the bottom of the list.
    • Select Debug from the tab listing on the left side.
    • Confirm that the path to the ArcGIS Pro .exe has been set and that the command line arguments have been set.

Edit the Pro splash screen and start page

  1. In the Solution Explorer > your project list > UI folder, double-click SplashScreen.xaml to open the splash screen file. Notice in Design view that it contains the name of your project. Click the text and then change it, for example, to “My New Config”.

  2. From the same UI folder, double-click StartPage.xaml. In Design view you should see a background image of some 3D buildings with a project selection box in the center.

  3. Customize the start page by adding a new TextBlock control from the Visual Studio Toolbox of Common WPF Controls, and include some text and basic formatting. You could alternatively add any other basic WPF control.

  4. Compile and build the project.

Run the project and create a shortcut

  1. Press Start to run the project in the Visual Studio debugger. Notice that your custom splash screen and start page open.

  2. Select an ArcGIS Pro project from the list or browse to one.

  3. After the project opens, notice that the standard ArcGIS Pro icon, located at the top-left corner of the application, has been replaced by a green, custom icon. Click Project > About. On the About pane, notice that the name of the configuration’s project is displayed below the title "About ArcGIS Pro".

  4. Close ArcGIS Pro.

  5. Right-click anywhere on your desktop and select New > Shortcut. In the space below “Type the location of the item:”, copy the path to the Pro .exe file path, as well as the command line arguments string from the Debug pane referenced in Step 5.

    Your path should look something like:

    Use dark colors for code blocksCopy
    "C:\Program Files\ArcGIS\Pro\bin\ArcGISPro.exe" /config:MyManagedConfiguration
  6. Click Next. Enter a name for the shortcut, and click Finish.

  7. Double-click your new desktop shortcut to start ArcGIS Pro and your configuration. You should see your custom splash screen and start page appear. You have now seen how a configuration file is normally started. Close ArcGIS Pro.

What's Next?

Learn how to use additional ArcGIS Pro SDK for .NET features in these tutorials:

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.