resolve-verification-issues

oleh flutter

Eliminate plugin verification warnings and errors (Internal API usage, Override-only API usage, etc.) identified by ./gradlew verifyPlugin.

npx skills add https://github.com/flutter/flutter-intellij --skill resolve-verification-issues

Skill: Resolve Plugin Verification Issues

You are tasked with eliminating plugin verification warnings and errors (Internal API usage, Override-only API usage, etc.).

Objective

Eliminate plugin verification warnings and errors (Internal API usage, Override-only API usage, etc.).

Workflow Instructions

1. Baseline

  • Run ./gradlew testClasses to ensure project compiles.
  • Run ./gradlew test and ./gradlew verifyPlugin to establish a clean baseline.

2. Analyze Report

  • Identify distinct issues to resolve (e.g., "Override-only API usage in ClassX").

3. Implement Fix

  • Resolve the specific issue in the current branch.
  • Ensure the fix is minimal and targeted.

4. Verify Fix

  • Run ./gradlew testClasses to ensure no new compilation errors.
  • Run ./gradlew verifyPlugin again to confirm the specific warning is gone and quantify the improvement.
  • Run ./gradlew test to ensure no regressions.

5. Validation & Manual Testing

  • Explain how to verify the fix manually by running ./gradlew runIde.
  • Provide specific navigation steps for the user to reach the changed code within the plugin (e.g. "Open Settings > Languages & Frameworks > Flutter...").
  • Verify that the changes do not introduce runtime errors or regressions.

6. Report & Review

  • Summarize the remaining verifyPlugin issues (e.g., "Total remaining issues: X compatibility warnings, Y internal API usages").
  • Confirm that ./gradlew runIde validation passed.
  • Test Location: Explicitly state where in the IDE the user should go to test the changed functionality (e.g., "Go to Preferences > Languages & Frameworks > Flutter").
  • Action: Ask the user to review the fix closely.
  • Do not commit or push.
  • Provide a suggested Git commit message including specific counts (e.g., "Fix Internal API usage in ClassX: 5 experimental APIs used -> 4 experimental APIs used").