esri/mapbook-wpf

Offline Mapbook example app built with WPF and the ArcGIS .NET Runtime SDK

Offline Mapbook WPF

This repo provides an open source app called Offline Mapbook built in WPF with the ArcGIS Runtime SDK for .NET. With very little customization, you can change the app to use your own data. Screenshots of the app and more detailed documentation can be found on the Developers Site.

• Features
• Detailed Documentation
• Development Instructions
  • Fork the repo
  • Clone the repo
    • Command line Git
    • Configuring a Remote for a Fork
• Requirements
• Resources
• Issues
• Contributing
• MDTOC
• Licensing

---

Features

• Mobile map packages
• Feature layers
• Identify
• Table of Contents
• Legend
• Locators with autosuggestions
• Bookmarks
• Portal Authentication using IWA and OAuth2

Detailed Documentation

Read the docs for a detailed explanation of the application, including its architecture and how it leverages the ArcGIS platform, as well as how you can begin using the app right away.

Development Instructions

This Offline Mapbook repo is a Visual Studio 2017 Project that can be directly cloned and imported into Visual Studio 2017 or higher.

Fork the repo

Fork the Offline Mapbook WPF repo.

Clone the repo

Once you have forked the repo, you can make a clone.

Command line Git

1. Clone the Offline Mapbook repo
2. cd into the mapbook-wpf folder
3. Make your changes and create a pull request

Configuring a Remote for a Fork

If you make changes in the fork and would like to sync those changes with the upstream repository, you must first configure the remote. This will be required when you have created local branches and would like to make a pull request to your upstream branch.

1. In the Terminal (for Mac users) or command prompt (fow Windows and Linux users) type git remote -v to list the current configured remote repo for your fork.
2. git remote add upstream https://github.com/Esri/mapbook-wpf.git to specify new remote upstream repository that will be synced with the fork. You can type git remote -v to verify the new upstream.

If there are changes made in the Original repository, you can sync the fork to keep it updated with upstream repository.

1. In the terminal, change the current working directory to your local project
2. Type git fetch upstream to fetch the commits from the upstream repository
3. git checkout master to checkout your fork's local master branch.
4. git merge upstream/master to sync your local master' branch withupstream/master. Note: Your local changes will be retained and your fork's master branch will be in sync with the upstream repository.

Requirements

• Visual Studio 2017 or higher
  • Visual Studio 2019 is required if you want to use the .NET Core version.
• .NET Framework 4.6.1 or higher
• ArcGIS Runtime SDK for .NET 100.11 or higher
• ArcGIS Runtime Toolkit for WPF v100.11 or higher

Resources

• Offline Mapbook documentation on Developers Site
• ArcGIS Runtime SDK for .NET Developers Site
• ArcGIS Developer Blog
• twitter@ArcGISRuntime
• twitter@esri

Issues

Find a bug or want to request a new feature enhancement? Let us know by submitting an issue.

Contributing

Anyone and everyone is welcome to contribute. We do accept pull requests.

1. Get involved
2. Report issues
3. Contribute code
4. Improve documentation

MDTOC

Generation of this and other documents' table of contents in this repository was performed using the MDTOC package for Atom.

Licensing

Copyright 2017-2019 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's LICENSE file.

For information about licensing your deployed app, see License your app.

mapbook-wpf's Issues

Bookmarks

Bookmarks are retrieved from the map document and listed in listview.
When user clicks on bookmark:

• they are zoomed/panned to the extent of the bookmark

Main screen

Create main screen of the app to contain:

• mmpk name
• mmpk thumbnail
• mmpk description
• mmpk download date
• all maps in mmpk
  • map name
  • map description
  • map thumbnail
  • clicking the map navigates to the map screen
• button to refresh (download) the mmpk

Cannot remove search pin once dropped

After a feature has been searched, the pin remains on the map (with no obvious way to dismiss/remove it). Granted, it can be moved if a new feature is searched, but doesn't appear possible to remove it altogether.

Add OAuth2 authentication

Reason: During design phase of the application, the decision was made that the app would use IWA since that is a very common pattern in enterprise WPF application. Post completion, it was decided to change authentication type in favor of OAuth2.

Update to 100.2

Update repo to 100.2 when released.

Overlay issue with titles in the center of the app interface

In the center of each map's header, several titles appear which overlap and obscure one another.

App crashes on shutdown - can't delete open MMPK

To resolve, the MMPK and all associated geodatabases should be closed before attempting deletion.

Implement WPF Toolkit

Use WPF toolkit to generate the Table of Contents with legend

"Invalid ArcGISRuntime deployment" error with 100.9

Got the following error with 100.9 in VS 2017:

The app did get through when I switch to 100.8.

Map screen

Create map screen for the app to contain:

• name of the map
• map itself
• button bar with all tool buttons
• back button to navigate back to mains screen

Attempting to run the app within a virtualized environment via Parallels throws exceptions

I have Parallels Desktop for Mac installed on my MacBook Pro. From within my Windows 10 'machine', double clicking the OfflineMapBook.exe to launch the application throws the following exceptions, in order:

Create download functionality

Add download functionality to the app.
Initial App Load

1. User is prompted for folder to store mmpk
2. App uses IWA to connect to portal
3. App downloads mmpk
4. App shuts down if unable to download mmpk

Subsequent App Loads

1. App loads, searches for mmpk existing mmpk. Compares download date to modified date
2. App downloads mmpk if not found locally or if newer version is available
3. App uses existing mmpk if unable to download new version

Search pin doesn't point at located feature

When searching for a feature, the tip of the pin does not point at the feature, but rather overlays it. Two examples:

WM-3991

WSVAL-4003

Identify features

Perform identify on features:

• when user taps on the map, run Identify on all available layers
• return popups for all features

Esri.ArcGISRuntime.Toolkit.WPF - version 100.2.0-beta3.42.g654578e5e6

I am just trying to build version upgraded to to 100.2 and there is reference to Esri.ArcGISRuntime.Toolkit.WPF - version 100.2.0-beta3.42.g654578e5e6. But the latest version I could find so far is 100.1.0-beta2 and that one is obviously not working well. Is that 100.2.0-beta available somewhere?

Locator

Use locator(s) to search for a feature:

• locator(s) are created in Pro and added inside the mmpk
• search bar allows user to type in search value
• locator suggestions are used to autocomplete search
• when user clicks on suggestion, locator returns best match for the searched value
• a pin is dropped in the searched location
• user is zoomed/panned to the searched location

Is it possible to use this app with Xamarin SDK?

How diffcult will it be to change it from the WPF SDK to the XAMARIN? :)
thinking about build one version to all 3 platform (Android, iOS and uwp :) )

Thanks,
Shahar.