R8 Analyzer

by android42dc2270e960Complete terms in LICENSE.txt7.7K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 13 days ago

Analyzes Android build files and R8 keep rules to identify redundancies, broad package-wide rules, and rules that subsume library consumer keep rules. Use when developers want to optimize their app's size, remove redundant or overly broad keep rules, or troubleshoot Proguard configurations.

Instructions only

Step 1. Setup and configuration check

  • Inspect build.gradle, build.gradle.kts, and gradle.properties.
  • Use references/CONFIGURATION.md [blocked] to identify missing optimizations.
  • AGP : If version is lower than 9.0, suggest migration to 9.0 for build-time performance improvement [blocked].
  • Full Mode : Verify android.enableR8.fullMode=false is removed from gradle.properties.

Step 2. Analysis path selection

  • Inspect build.gradle, build.gradle.kts, and gradle.properties and libs.versions.toml to get the AGP and R8 versions.

  • If AGP >= 9.3.0 : Proceed to Path A (Standalone Task).

  • If AGP < 9.3.0 and R8 >= 9.3.7-dev : Proceed to Path B (Quantitative).

  • If none of the conditions are met, proceed to Path C (Heuristic).

Path A: Standalone Gradle task (AGP >= 9.3.0)

  • Step 1: Run standalone task : Run ./gradlew :app:analyzeReleaseR8Config to evaluate the R8 configuration. You MUST wait for this command to finish before proceeding.
  • Step 2: Convert to JSON : The report is generated at app/build/reports/r8/r8-config-analyzer-release.pb. You MUST explicitly run the conversion script by executing: python3 .agents/skills/r8-analyzer/scripts/convert_pb_to_json.py. Wait for this command to finish.
  • Step 3: Analyze : You MUST explicitly run the analysis script by executing: python3 .agents/skills/r8-analyzer/scripts/analyze.py. This outputs tmp/keepradius/analysis_result.txt. Wait for this command to finish.

Path B: Quantitative data generation (R8 >= 9.3.7-dev and AGP < 9.3.0)

  • Step 1: Check requirements : Python and protobuf package are mandatory.
  • Step 2: Generate and analyze : You MUST run the shell commands described in references/CONFIGURATION-ANALYZER.md [blocked] to generate the proto file using R8 configuration analyzer, convert it to JSON and analyze the result.
  • Step 3: Analyze : You MUST ensure the analysis produces tmp/keepradius/analysis_result.txt for scores and rule impact metrics.

Path C: Heuristic evaluation and recommendation (R8 < 9.3.7-dev)

(Use ONLY if quantitative data generation is not possible)

  • Step 1: Manual evaluation : Inspect proguard-rules.pro.
  • Step 2: Library check : Compare rules against references/REDUNDANT-RULES.md [blocked]. Suggest Remove for bundled rules.
  • Step 3: Custom rule check : Use references/KEEP-RULES-IMPACT-HIERARCHY.md [blocked] and references/REFLECTION-GUIDE.md [blocked] to prioritize and evaluate. Suggest Refine for broad rules (for example, package-wide).
  • Step 4: Validation : Suggest Macrobenchmark tests using UI Automator [blocked] for any proposed changes. Proceed to Step 3.

Step 3. Report generation

  • Format : Follow references/REPORT_FORMAT.md [blocked] strictly.
  • Input: Extract metrics (Scores, Impacts, Example Classes) directly from generated file analysis.txt if using Path A, or from manual findings if using Path B.
  • Output : Output ONLY the raw Markdown report in the chat. Do NOT output conversational filler (for example, "Here is your report..."). Do NOT provide recommendations, next steps, or any other text outside of the sections defined in references/REPORT_FORMAT.md [blocked] Do NOT mention the path used for analysis of the configuration

Constraints

  • Strict output limit: The final output MUST strictly be the Markdown report and nothing else.
  • No code changes: Research and suggest only; Do not modify files.
  • No redundancy: Do not explain R8 benefits or reference skill internal files in the report.
  • Focus: Omit sections (for example, Subsumed Rules, Configuration) if no issues or items are found.

Source and attribution

Source:android/skillsinperformance/r8-analyzerat commit42dc227

License: Complete terms in LICENSE.txt

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from android/skills

Wear Compose M3

android

Guides building, updating and migrating Wear OS Compose Material3 apps, with canonical component samples and version rules.

Software Development7.7Kupdated 13 days ago

Display Glasses With Jetpack Compose Glimmer

android

Provides guidelines for developing projected Android XR apps for display glasses using the Jetpack Compose Glimmer UI toolkit. This skill covers foundational Glimmer design principles, workflows for implementing Jetpack Compose Glimmer, and interaction models for the glasses form factor. Use this skill to build an Android XR Augmented Experience app with Jetpack Compose Glimmer that adheres to the Glimmer design system for optimized glasses styling.

Awaiting classification7.7Kupdated 13 days ago

Play Billing Library Version Upgrade

android

Guides upgrading an Android project from a legacy Google Play Billing Library version to the latest stable release.

Software Development7.7Kupdated 13 days ago

Leanback To Compose Tv Migration

android

Provides instructions and architectural patterns for migrating Android TV applications from legacy Leanback UI Toolkit, Android Views, or Support Fragments to Jetpack Compose for TV (androidx.tv). Use this skill for Leanback to Compose migrations, including browse screen, settings screen, authentication screen, login screen, or video playback screen migrations, or when replacing BrowseSupportFragment, LeanbackSettingsFragment, PreferenceFragment, BaseLeanbackPreferenceFragmentCompat, VideoSupportFragment, GuidedStepSupportFragment, SearchSupportFragment, VerticalGridSupportFragment, Presenter, ArrayObjectAdapter, or CursorMapper with modern Compose equivalents, implementing immersive carousels with focus memory, Media3 video playback with PlayerSurface, or custom 10-foot hero layouts.

Awaiting classification7.7Kupdated 13 days ago

Testing Setup

android

Analyzes an Android project's testing setup and installs testing frameworks, harnesses and tests for unit, UI, screenshot and end-to-end coverage.

Software Development7.7Kupdated 13 days ago

Android Profiler

android

Guides Android performance profiling: recording system traces, heap dumps and method recordings, and analyzing them with Perfetto SQL.

Software Development7.7Kupdated 13 days ago