Ecological Marine Unit Explorer Android
This repo is home to the ArcGIS Ecological Marine Unit (EMU) example application. The app uses the ArcGIS Runtime SDK for Android to showcase ocean ecosystems.
Explore 50 years worth of NOAA data using Esri maps and services!
This EMU Explorer repo is an Android Studio Project and App Module that can be directly cloned and imported into Android Studio.
Fork the repo
Fork the Ecological Marine Unit Explorer Android repo.
Clone the repo
Once you have forked the repo, you can make a clone
Command line Git
- Clone the Ecological Marine Unit Explorer repo
- 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.
- In the Terminal (for Mac users) or command prompt (fow Windows and Linux users) type
git remote -vto list the current configured remote repo for your fork.
git remote add upstream https://github.com/Esri/ecological-marine-unit-android`gitto specify new remote upstream repository that will be synced with the fork. You can type
git remote -vto 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.
- In the terminal, change the current working directory to your local project
git fetch upstreamto fetch the commits from the upstream repository
git checkout masterto checkout your fork's local master branch.
git merge upstream/masterto 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.
Configure Runtime Lite License (optional)
While the Ecological Marine Unit Explorer application references a Runtime Lite license file, it is not required to run the app. To learn more about licensing your Runtime app, see the documentation here. The Ecological Marine Unit Explorer is completely functional without the Runtime Lite license. We have used a Runtime Lite license to remove the "Licensed for Developer Use Only" watermark from the map since this app has often been used in demos. If you have a ArcGIS Developer account you can generate your ArcGIS Runtime Lite license and use the following steps to use it in your app.
- In the app modules build.gradle uncomment line 33
buildConfigField "String" , "LICENSE_KEY" , LICENSE_KEY
- Create a file named gradle.properties in the root of the project. Assign your license key as a Value/String pair, e.g.:
- Uncomment line 104 in the MainActivity.java file that sets the license:
- Sync your gradle file and re-run the app.
Signing a release APK
- Create a file named
keystore.propertiesin the root of the project.
- Add the following content with your signing info:
storePassword=myStorePassword keyPassword=mykeyPassword keyAlias=myKeyAlias storeFile=myStoreFileLocation
- Open the Build Variants tool in Android Studio and ensure release build type is selected
- Click Build > Build APK and confirm that Android Studio has created a signed APK in the
- Ecological Marine Unit Explorer
- ArcGIS Runtime SDK for Android Developers Site
- ArcGIS Mobile Blog
- ArcGIS Developer Blog
Find a bug or want to request a new feature enhancement? Let us know by submitting an issue.
Anyone and everyone is welcome to contribute. We do accept pull requests.
- Get involved
- Report issues
- Contribute code
- Improve documentation
Copyright 2017 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
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.
(Esri Tags: ArcGIS Android Mobile) (Esri Language: Java)