{"id":29009702,"url":"https://github.com/grab/app-sizer","last_synced_at":"2025-06-25T15:12:11.707Z","repository":{"id":264145295,"uuid":"844915208","full_name":"grab/app-sizer","owner":"grab","description":"A tool designed to analyze the download size of Android applications. Provides detailed insights into app binary composition through a Gradle plugin and CLI tool to help developers optimize app size and improve user acquisition.","archived":false,"fork":false,"pushed_at":"2025-04-03T16:18:29.000Z","size":72348,"stargazers_count":196,"open_issues_count":4,"forks_count":10,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-03T16:42:14.244Z","etag":null,"topics":["android","app-size","custom-gradle-plugin","gradle-plugin","grafana"],"latest_commit_sha":null,"homepage":"https://grab.github.io/app-sizer/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grab.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-20T08:07:12.000Z","updated_at":"2025-04-03T15:58:34.000Z","dependencies_parsed_at":"2025-03-12T02:38:06.712Z","dependency_job_id":null,"html_url":"https://github.com/grab/app-sizer","commit_stats":null,"previous_names":["grab/app-sizer"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/grab/app-sizer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grab%2Fapp-sizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grab%2Fapp-sizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grab%2Fapp-sizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grab%2Fapp-sizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grab","download_url":"https://codeload.github.com/grab/app-sizer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grab%2Fapp-sizer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261897063,"owners_count":23226653,"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","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":["android","app-size","custom-gradle-plugin","gradle-plugin","grafana"],"created_at":"2025-06-25T15:12:10.875Z","updated_at":"2025-06-25T15:12:11.649Z","avatar_url":"https://github.com/grab.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# App Sizer\nSee the [project website][app_sizer_website] for documentation and APIs.\n\n## Overview\nApp Sizer is a tool designed to analyze the download size of Android applications. By providing detailed insights into the composition of your app's binary, App Sizer helps developers identify areas for size reduction, ultimately improving user acquisition and retention rates.\n\n*The app download size in Android refers to the amount of data a user needs to download from an app store (typically Google Play Store) to install an application on their Android device*\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"./docs/images/dashboard.gif\" width=\"95%\"\u003e\n\u003c/p\u003e\n\n## Key Features\n\nApp Sizer offers comprehensive analysis including:\n\n1. Total app download size\n2. Detailed size breakdown\n3. Size contribution by teams\n4. Module-wise size contribution\n5. Size contribution by libraries\n6. List of large files\n\nReports are generated based on the provided Android device specifications. Our [blogpost][blog_post] introduce the tool features\n\n## Integration\n\nApp Sizer provides two flexible integration methods:\n\n* A Gradle plugin that seamlessly integrates with your Android Gradle project ([Plugin Configuration Detail][plugin_doc].)\n* A command-line tool to cater to non-Gradle build systems, offering the same comprehensive features ([Commandline Configuration Detail][cli_doc].)\n\n  *Note: The command-line option was the original implementation and remains supported for broader compatibility.*\n\n\n## Report Types\n\nApp Sizer currently supports three types of reports:\n\n* InfluxDB database (1.x) - It is suitable for CI tracking and enabling the creation of customized dashboards (with visualization tools like Grafana). We provide an InfluxDB and Grafana setup; see our [Docker Setup Guide][grafana_docker_doc].\n* Markdown table for convenient local analysis.\n* JSON data for compatibility with other platforms.\n\n*The Markdown \u0026 Json reports are saved as [option]-report.md in the configured output folder (default: app/build/sizer/reports)*\n\nFor more detail on reports, see [Report Detail][report_doc]\n\n## How it works\n\nApp Sizer functions as a mapping tool to generate the report. It takes APK, AAR, and JAR files as inputs.\n\n1. **Input parsing**:\n    - The tool parses the APK down to file and class levels. It calculates the contribution of each component to the total app download size.\n    - Similarly, App Sizer parses AAR and JAR files.\n\n2. **Mapping and Report Generation**:\n    - The tool then maps the APK components to their corresponding elements in the AAR and JAR files.\n    - Based on this analysis and other metadata, App Sizer generates comprehensive reports detailing size contributions.\n\n## Limitations\n\nApp Sizer approximates class download sizes due to Dex structure complexity, and may not accurately attribute sizes for inline functions or uncategorized files. Results should be interpreted as close estimates, best used for identifying trends and relative size comparisons rather than exact measurements.\n\nFor more details on limitations, see the [Limitation][limitation_doc].\n\n## Components\n* [Gradle Plugin][gradle_plugin]\n* [Command line tool][commandline_tool]\n* [InfluxDb \u0026 Grafana Docker][grafana_docker]\n\n## Contributing\n\nIf you find any issues or have suggestions for improvements, please open an issue or submit a pull request to the App Sizer repository.\n\n## License\n\n```\nMIT License\n\n\nCopyright 2024 Grabtaxi Holdings Pte Ltd (GRAB), All rights reserved.\n\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE\n\n```\n[app_sizer_website]: https://grab.github.io/app-sizer/\n[report_doc]: https://grab.github.io/app-sizer/report/\n[plugin_doc]: https://grab.github.io/app-sizer/plugin/\n[cli_doc]: https://grab.github.io/app-sizer/cli/\n[grafana_docker_doc]: https://grab.github.io/app-sizer/docker/\n[limitation_doc]:https://grab.github.io/app-sizer/limitation/\n[blog_post]: https://engineering.grab.com/project-bonsai\n[latest_release_link]: https://github.com/grab/app-sizer/releases\n[gradle_plugin]: ./sizer-gradle-plugin\n[commandline_tool]: ./cli\n[grafana_docker]: ./docker\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrab%2Fapp-sizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrab%2Fapp-sizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrab%2Fapp-sizer/lists"}