ArcProViewer

This repository contains the Riverscapes Viewer for ESRI's ArcGIS Pro. This is an addin for ArcGIS that provides the ability to open and view Riverscapes compliant projects.

ArcProViewer replaces the old ArcViewer ArcGIS 10.x for ArcMap version, and provides the same functionality as the QViewer for QGIS.

Documentation

See the Riverscapes Viewer site.

Minimum Requirements

ArcGIS Pro version 3.3.

License

GNU GENERAL PUBLIC LICENSE

Development

ArcProViewer is written in c# and developed with Visual Studio 2022. It uses WPF (as opposed to the old WinForms and the newer WinUI user interface technologies.)

Configuring a build environment requires that you follow the steps on ESRI's build my first addin for ArcPro. The key step in this setup is to install the ArGIS Pro SDK for .Net. This is performed inside Visual Studio itself using the Extension Manager (as opposed to running a standalone installer).

Development Setup

1. Install Visual Studio 2022 Community Edition.
2. Install ArcPro.
3. If developing for the latest version of ArcPro (3.3 at time of writing) then: 1.1 Open Visual Studio and go to Extensions menu and choose Manage Extensions. 1.1 Search for ArcPro and install the SDK extensions.
4. If developing for older version of ArcPro then go to ArcPro SDK repo and searches the releases for the desired version of ArcPro. Download the *.vis files from the binaries in the release and then double click these on your computer to install them.

Note: ArcPro 3.1 uses .net 6 while ArcPro 3.3 uses .net 8.

Deployment

1. Increment the version number.
2. Commit and push all your changes. Also pull to ensure you have the latest code.
3. Create a tag for the release that matches the version number. Commit and push this tag to GitHub.
4. Switch to Release build.
5. Rebuild the software solution.
6. Navigate to the build folder.
7. Create a new Release on the GitHub repository releases that references the new tag.
8. Provide a name and description and drag the ArcProViewer.esriAddinX file into the binaries section.
9. Save the release.
10. Announce the release on the Riverscapes Consortium community platform.

Notes

• Does NOT ship with a copy of business logic or symbology. Users must synchronize this manually after installation.
• Uses *.lyvrx files symbology. It is incompatible with the *.lyr files uses by ArcViewer for ArcMap 10.x.
• Does not possess an upload feature for uploading projects to the Riverscapes Data Exchange.