{"id":23235864,"url":"https://github.com/billmeyer/nationalparks-android","last_synced_at":"2025-10-11T09:15:54.323Z","repository":{"id":89566099,"uuid":"416076325","full_name":"billmeyer/nationalparks-android","owner":"billmeyer","description":null,"archived":false,"fork":false,"pushed_at":"2021-11-12T19:32:27.000Z","size":549,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T20:36:01.716Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/billmeyer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-11T20:28:03.000Z","updated_at":"2021-11-12T19:32:30.000Z","dependencies_parsed_at":"2023-06-29T03:00:36.757Z","dependency_job_id":null,"html_url":"https://github.com/billmeyer/nationalparks-android","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/billmeyer/nationalparks-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billmeyer%2Fnationalparks-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billmeyer%2Fnationalparks-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billmeyer%2Fnationalparks-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billmeyer%2Fnationalparks-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/billmeyer","download_url":"https://codeload.github.com/billmeyer/nationalparks-android/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billmeyer%2Fnationalparks-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006752,"owners_count":26084177,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-19T03:29:46.080Z","updated_at":"2025-10-11T09:15:54.306Z","avatar_url":"https://github.com/billmeyer.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# National Parks - Android\n\n## Setup\n\n1. A \"Global\" `gradle.properties` file is needed to supply the necessary configuration items needed to build the Android application.  This file is typically located in the user's HOME directory under a directory named `.gradle`.  Start by creating this directory if it doesn't exist:\n   \n   ```bash\n   $ mkdir $HOME/.gradle\n   ```\n\n2. Create the `$HOME/.gradle/gradle.properties` file with the following content:\n  \n   ```bash\n   RUM_ACCESS_TOKEN=\u003ctoken\u003e\n   RUM_REALM=\u003crealm\u003e\n   REST_BACKEND=\u003cbackend_url\u003e\n   ```\n\n   where:\n\n    * `\u003ctoken\u003e` should be replaced with a __RUM__ token from your Splunk Observability account.  See [https://app.\u003cSPLUNK_REALM\u003e.signalfx.com/#/organization/current?selectedKeyValue=sf_section:accesstokens]() for available tokens.\n    * `\u003crealm\u003e` is the realm your Splunk Observability account is available in. (e.g., `us0`, `us1`, `eu0`, etc.)\n    * `\u003cbackend_url\u003e` is the URL to the National Parks REST backend in the format **http(s)://(hostname|ip address):(port)**. Example: `http://192.168.3.233`.\n\n3. To set up this project, first clone the repository\n\n    ```bash\n    $ git clone https://github.com/billmeyer/nationalparks-android.git\n    ```\n\n4. Build the project into an APK file.\n\n   ```bash\n   $ cd nationalparks-android\n   $ ./gradlew assemble\n   ```\n\n## Run\n\n1. Open the project in **Android Studio** and run on a physical device or emulator.\n\n## Evaluate\n\n1. The application starts with creation of an instance of `NationalParksApplication` in which the `onCreate()` method initializes the Splunk Observability RUM module:\n\n   ```java\n     Config config = Config.builder()\n             .applicationName(\"National Parks\")\n             .rumAccessToken(BuildConfig.RUM_ACCESS_TOKEN)\n             .realm(BuildConfig.RUM_REALM)\n             .deploymentEnvironment(\"development\")\n             .debugEnabled(true)\n             .build();\n     SplunkRum.initialize(config, this);\n\n     SplunkRum sr = SplunkRum.getInstance();\n   ```\n\n   The `BuildConfig.RUM_ACCESS_TOKEN` and `BuildConfig.RUM_REALM` are provided by the configuration done on step 2 from the **Setup** section above.\n\n2. The app consists of two **Fragments**:\n\n   * `HealthCheckFragment`- calls the Health Check endpoint (`/api/v1/health-check`) to confirm it's up.  If so, the response `\"API is up and running\"` is returned from the Health Check endpoint and displayed in the center of the Fragment.\n   \n   ![Health Check Fragment](images/health-check.png)\n\n   * `NationalParksFragment`- calls the National Parks endpoint (`/api/v1/nationalparks`) to fetch a random set of National Parks.  Each time the Fragment displayed, a new random set will be retrieved.\n   \n   ![National Parks Fragment](images/national-parks.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbillmeyer%2Fnationalparks-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbillmeyer%2Fnationalparks-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbillmeyer%2Fnationalparks-android/lists"}