{"id":30142151,"url":"https://github.com/local-connectivity-lab/lcl_measurement_tool-android","last_synced_at":"2026-03-01T13:34:50.141Z","repository":{"id":246841609,"uuid":"378266578","full_name":"Local-Connectivity-Lab/lcl_measurement_tool-android","owner":"Local-Connectivity-Lab","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-16T00:33:42.000Z","size":11129,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-16T08:17:13.484Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","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/Local-Connectivity-Lab.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-06-18T21:17:33.000Z","updated_at":"2026-02-08T02:15:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"06de9ebb-9946-45e0-bcfc-8207756aa1c4","html_url":"https://github.com/Local-Connectivity-Lab/lcl_measurement_tool-android","commit_stats":null,"previous_names":["local-connectivity-lab/lcl_measurement_tool-android"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Local-Connectivity-Lab/lcl_measurement_tool-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Flcl_measurement_tool-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Flcl_measurement_tool-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Flcl_measurement_tool-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Flcl_measurement_tool-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Local-Connectivity-Lab","download_url":"https://codeload.github.com/Local-Connectivity-Lab/lcl_measurement_tool-android/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Flcl_measurement_tool-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29970468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T13:32:00.443Z","status":"ssl_error","status_checked_at":"2026-03-01T13:32:00.084Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2025-08-11T05:41:36.392Z","updated_at":"2026-03-01T13:34:50.123Z","avatar_url":"https://github.com/Local-Connectivity-Lab.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LCL Network Performance Measurement Tool\n\n**Warning: This doc is outdated! Will update once the kotlin integration is complete.**\n\n**LCL Network Measurement Tool** is an Android App that measures a variety of network metrics, including but not limited to *ping*, *upload/download* speed, *signal strength*.\nIt also automatically uploads the testing results to the backend server, which will then be displayed on [our coverage map](https://coverage.seattlecommunitynetwork.org/).\n\n## Project Structure\n```\napp/src/main/java\n└── com\n    └── lcl\n        └── lclmeasurementtool\n            ├── Utils\n            ├── Receivers\n            ├── Models\n            ├── Managers\n            ├── Functionality\n            ├── Database\n            │   ├── Entity\n            │   └── DB\n            └── Constants\n```\n\nIn each sub-directory, there is a README file explaining the module. \n\n\n## Building, Running, and Installing the project\n### Prerequisite\n* We use Android Studio for development. Download the latest version of Android Studio [here](https://developer.android.com/studio).\n  * Android SDK 30 (make sure you have SDK version 30 or above)\n  * Android NDK    (Download the latest NDK either from Android's website or in Android Studio)\n  * Android Emulator\n* Git\n\n### Managing SDK, NDK, and Emulators\nAndroid Studio has tools to help manage the SDK, NDK, and Emulators resources.\n\n![SDK, NDK, Emulator Manager](docs/img/sdk_ndk_emulator.png)\n\n#### SDK and NDK\nAndroid SDK is a component for building apps on Android platform.\nAndroid NDK is a toolset that lets you implement parts of your app in native code, using languages such as C and C++.\n\nTo properly configure SDK and NDK for the project. First go to the `SDK Platform` pane, and check the SDK with API level equal to or greater than 30.\n![Android SDK](docs/img/android_sdk.png)\n\nThen click `SDK Tools`, make sure at least NDK and CMake are checked. \n![Android SDK Tools](docs/img/android_sdk_tools.png)\n\nFinally, click `OK` and wait for these tools to be installed.\n\n#### Emulators\nIf you do not have a Andriod Phone, you can install emulators to run the app. Click the `Device Manager` button in the middle. Then click `Create device`.\nSelect a phone target (we recommend using Pixel 4). Then select your system image, which should match your API level. Finally click `Finish` and wait for the emulator to be created.\n![Android Device Manager](docs/img/device_manager.png)\n\nFor more information, visit [Android Developer Website](https://developer.android.com/studio/releases/platforms)\n\n### Building, Running and Debugging the Code\nAndroid Studio provides out-of-box build tool and debugger to help build, run, and debug.\n\n#### Open the project\n* In order to build the code, clone this project repo to your working folder \n  * using HTTPS: `$ git clone https://github.com/Local-Connectivity-Lab/lcl_measurement_tool.git`\n  * using SSH if you have set it up: `$ git@github.com:Local-Connectivity-Lab/lcl_measurement_tool.git`\n* `cd` into the directory `lcl_measurement_tool` and change the branch from `main` to `develop` to view the latest codebase `$ git checkout dev`\n* Open the project using Android Studio. Wait for Android Studio to automatically install Gradle and other dependencies used by the project.\n* Under the top-level directory of this project, where this README.md lives, create a new file `iperfkey.properties` and ask either Esther Jang or Zhennan Zhou for the keys.\n\n#### Building the project\n* On the top menu bar, find the `Build -\u003e Clean Project` to remove any previous build. Then `Build -\u003e Rebuild Project`.\n* [Optional] On the bottom menu bar, find the Build Panel and view the Build process.\n\n#### Running/Debugging the project\nAfter building the project, we can use Android Studio's \"Play\" button in the toolbar to run the project on an actual Android phone or in the Emulator of your choice.\nIf you need to debug the code, add breakpoints and then click the `bug` button in the toolbar. Android Studio will pop up a debugger attached to the process. \n![AndroidStudio toolbar](docs/img/androidstudio_tool_bar.png) Make sure the target shows as `app`. \n\n#### Profiling and Inspection\nIf you need to inspect the network packet or checking the app's running state, you can use Android Studio's built-in profiler located at the bottom toolbar.\nMake sure you open the profiler when the app is running. To inspect the database, using the App Inspection tool located at the bottom toolbar.\n\n\n## Contributing to the Project\nWe are excited to work alongside you, our amazing community, to build and enhance this measurement tool! If you want to contribute to this project, contact Esther Jang(infared) or Zhennan Zhou(Johnnnzhou) in our Discord channel. \n\n### Getting involved with Seattle Community Networks Team\nIf you are interested in contributing to the community, visit our [website](https://seattlecommunitynetwork.org/), join our [Discord channel](https://discord.gg/sZkK5RpeCE),\nand follow us on social media: [Instagram](https://instagram.com/seattlecommnet), [Facebook](https://facebook.com/seattlecommnet), and [Twitter](https://twitter.com/seattlecommnet).\n\nFor more information, visit our [Get Started Pro Tips](https://docs.seattlecommunitynetwork.org/get-started.html).\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocal-connectivity-lab%2Flcl_measurement_tool-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flocal-connectivity-lab%2Flcl_measurement_tool-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocal-connectivity-lab%2Flcl_measurement_tool-android/lists"}