ArcGIS Runtime SDK for Android: Building Apps. Shelly Gill

Transcription

1 ArcGIS Runtime SDK for Android: Building Apps Shelly Gill

2 Agenda Getting started API - Android Runtime SDK patterns - Common functions, workflows The Android platform Other sessions covered Runtime SDK generally: An Introduction to the API and Architecture, Building 3D Applications, Working with Maps Online and Offline

3 Getting started With a tutorial, gradle, or samples

4 Getting started with the SDK 1. Sign up for free Developers testing account - 50 credits a month, premium content, register apps, test tokens 2. Install free Android Studio IDE Get dependencies automatically with Gradle and try it out - Write an app!

5 New developers - Follow first map app tutorial Developers site > Android > Guide Help topics Getting started > Develop your first map app Step-by-step guide Or try Dev Labs - 8 so far -

6 Existing developers - clone samples or example apps GitHub - API samples - Java, and adding Kotlin - Example apps Clone/checkout/download, import, and run

7 Existing apps - add AAR dependency Maven repository hosted by Bintray - AARs of current and previous releases Project build.gradle repositories { maven { url ' } App module build.gradle dependencies { compile 'com.esri.arcgisruntime:arcgis-android: ' }

8 SDK resources Developers site Doc guide, API Reference - Downloadable SDK - Application support GitHub for samples and example apps GeoNet user communities

9 Example apps Real world apps based on use cases collected from users Complete working apps with detailed instructions for getting started Supporting documentation - code, data creation, app workflows, customization Open sourced on GitHub (Apache 2.0 license) Current Android apps: - Maps App, Ecological Marine Units, Nearby Places, Offline Mapbook Future apps: - Mobile data collection, Situational awareness - Vote at

10 Functionality Build apps for Android devices Visualize geographic data maps, scenes, layers, graphics - feature, dynamic, tiled, raster, Identify features, query data, and display info pop-ups Share maps and content across ArcGIS platform Offline maps, data, routing, geocoding Powerful analysis and local geometric operations

11 API

12 ListenableFuture pattern Asynchronous methods use ListenableFuture - Inherits from java Future interface - A promise to return a result - Add done listener, or call get (blocking) Can simplify asynchronous programming - Done called back on UI thread if listener added on UI thread - We take care of executing operations on background threads - Standard pattern for cancellation, errors

13 ListenableFuture Sample identify-graphics-hittest

14 // Get future ListenableFuture<Boolean> = mmapview.setviewpointasync(firstviewpoint, 3); // Add done listener booleanlistenablefuture.adddonelistener(new Runnable() public void run() { try { // get result of the future if (MainActivity.this.booleanListenableFuture.get()) { // Proceed with more mmapview.setviewpointasync(secondviewpoint, 3); } } catch (InterruptedException ie) { // user interrupted the operation } catch (ExecutionException ee) { // a problem with executing the call or returning result } } });

15 ListenableList pattern Bind to data Add listener to know when content changes - Adds and removes Implemented on - Graphics in a GraphicsOverlay - LayerList (operational, base, reference layers) - Sublayers in SublayerList - Bookmarks

16 Loadable pattern Java implementation Loadable resources - Maps, layers, portal item, geodatabase, Does not use ListenableFuture - Specific pattern for load errors - Has additional states - Can reload if failed Loads dependent loadables

17 Map and MapView Content and presentation are separated ArcGISMap - separate class that defines content - Listenable lists of Layer, Bookmark - MapView references ArcGISMap - Open a map, or build in code, modify, save to portal MapView extends android.view.viewgroup - GraphicsOverlay(s), LocationDisplay, - Control visible extent of ArcGISMap using Viewpoints Don't forget andoid.permission.internet for any online layers, basemaps, portals, etc

18 Scene and SceneView New in Android at v100.1 ArcGISScene content - SceneView references ArcGISScene - Basemap, ElevationSurface, Layers, - Build in code SceneView extends android.view.viewgroup - Control view using Viewpoints and Cameras Currently requires OpenGL2.0 - Covers all devices connecting to Google Play

19 Scene and layer Code Display a scene Add elevation surface Add a scene layer

20 // create a scene and add a basemap to it ArcGISScene scene = new ArcGISScene(); scene.setbasemap(basemap.createimagery()); msceneview = findviewbyid(r.id.sceneview); msceneview.setscene(scene); // create an elevation source, and add this to the base surface of the scene ArcGISTiledElevationSource elevationsource = new ArcGISTiledElevationSource(getResources().getString(R.string.elevation_source)); scene.getbasesurface().getelevationsources().add(elevationsource); // add a scene service to the scene for viewing buildings ArcGISSceneLayer scenelayer = new ArcGISSceneLayer( getresources().getstring(r.string.buildings_service)); scene.getoperationallayers().add(scenelayer); // add a camera and initial camera position Camera camera = new Camera(48.378, , 200, 345, 65, 0); msceneview.setviewpointcamera(camera);

21 Display device location Uses Android platform location providers - GPS and network location, if enabled Customizable appearance AutoPan behavior pan, rotate - Navigation (car) - CompassNavigation (waypoint) - Recenter (no rotation) LocationDisplay - MapView.getLocationDisplay() - LocationDisplay.startAsync() Only Position Position & Heading Position & Course

22 LocationDisplay top tips Don t forget - android.permission.access_coarse_location + - android.permission.access_fine_location User interactive navigation cancels auto-pan - MapView.addNavigationChangedListener when isnavigating returns to false, re-set the AutoPanMode - Or disable interactive navigation User interactive navigation can also change scale - Again can use addnavigationchangedlistener and re-set map scale if required Can create own LocationDataSource if required

23 Handling touch on the map Default navigation gestures - Swipe to pan - Double-tap = zoom in, two-finger-tap = zoom out - Pinch to zoom and rotate - Tap and hold then swipe up/down for continuous zoom Change interactive navigation by creating custom touch listener - Inherit from DefaultMapViewOnTouchListener - Implement View.OnTouchListener

24 Handling gestures Sample identify-graphics-hittest

25 Integration with the ArcGIS Platform using Portal API Portal - Connection to ArcGIS Online or an on-premises Portal - Authenticated and anonymous access PortalUser - Current authenticated user or other users PortalItem - Represent any item type - Create, update, delete items and PortalFolders - Share publicly, organization, or PortalGroup

26 MobileMapPackage Provide offline maps so users can be productive when network connectivity is poor or nonexistent MobileMapPackage class - maps, layers, data, locators, transportation networks Desktop pattern - Create MMPK in Pro Services pattern - Use OfflineMapTask ArcGIS Runtime SDKs: Working with Maps Online and Offline 2pm - B 07 - B 08

27 Offline Mapbook Example App Offline Mapbook Example App

28 Authentication default challenge handler Cross-platform security pattern - Challenges, challenge handlers, OAuth2, tokens DefaultAuthenticationChallengeHandler - Out of the box UX for challenges - Network credential: HTTP secured service / Integrated Windows Authentication (IWA). - ArcGIS Tokens: proprietary token-based authentication - PKI certificates - Self signed certificates Create own handler if required - Implement AuthenticationChallengeHandler

29 Security pattern OAuth 2.0 Used by ArcGIS Online OAuthConfiguration - Provides challenge handling specifically for OAuth - Uses default Android browser app to display login UX Set this up - Create Application - Developers site account - Set DefaultAuthenticationChallengeHandler - Create OAuthConfiguration

30 Authentication code Maps App example app: AuthenticationManager DefaultAuthenticationChallengeHandler OAuthConfiguration

31 Android Platform

32 Android Platform Android platforms: connections to Google Play store 2 nd Oct 2017 Runtime SDK supports minimum Android API 16 ( Jelly Bean Android 4.1) defaultconfig { minsdkversion 16 } No need for separate JDK What about your deployments? - API 16 (Jelly Bean)? - API 19 (Kit Kat)? - API 24 Nougat or forward Nougat + Oreo Marshmallow Lollipop KitKat Jelly Bean Older

33 Android Studio 3 Significant update to Android Studio - IDE - Parameter hints, semantic highlighting - Tooling Debugging, Instant Apps templates, Android Profiler, new gradle plugin + optimizations Release Candidate 2 Oct 19 th Final released last night! Java 8 language features as standard Migrate projects forward from release Supports Kotlin

34 Kotlin New official language - Interoperable with Java, Java standard types - Open source, by JetBrains - Modern language features - Null safety/nullable types, default parameter values - Lambdas, inferred properties, higher order functions + function types, auto-casting Support in Runtime SDK - Migrating samples - Future plans for documentation - Example apps - ask at

35 In conclusion Free to get going - Android Studio - Free Developers account for testing - ArcGIS Runtime SDK for Android Runtime SDK support for wide range of functionality and workflows GeoNet questions, discussions, suggestions Feedback in the conference app

36

37 Thank You to Our Generous Sponsor