API. Add AnalysisContextCollection.dispose() to API.

Bug: #56102
Change-Id: I06a53805514655fa01e962bbc98255b5e70f3ed8
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/375720
Reviewed-by: Brian Wilkerson <brianwilkerson@google.com>
Commit-Queue: Konstantin Shcheglov <scheglov@google.com>

pkg/analyzer/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 6.8.0-dev
+* Add `AnalysisContextCollection.dispose()`. It must be invoked at the end.
+
 ## 6.7.0
 * Deprecated `File.createSource()`, it violates levels of abstraction.
   You can get `Source` instances from `AnalysisResult`s.

pkg/analyzer/lib/dart/analysis/analysis_context_collection.dart

@@ -20,6 +20,8 @@ abstract class AnalysisContextCollection {
   ///
   /// If [sdkPath] is given, then Dart SDK at this path will be used, otherwise
   /// the default Dart SDK will be used.
+  ///
+  /// [dispose] must be invoked after collection is finished being used.
   factory AnalysisContextCollection({
     required List<String> includedPaths,
     List<String>? excludedPaths,
@@ -34,4 +36,7 @@ abstract class AnalysisContextCollection {
   /// given [path], or throw [StateError] if the [path] is not analyzed in any
   /// of the created analysis contexts.
   AnalysisContext contextFor(String path);
+
+  /// Stops associated processes, and free resources.
+  Future<void> dispose();
 }

pkg/analyzer/lib/src/dart/analysis/analysis_context_collection.dart

@@ -156,6 +156,7 @@ class AnalysisContextCollectionImpl implements AnalysisContextCollection {
     throw StateError('Unable to find the context to $path');
   }
 
+  @override
   Future<void> dispose({
     bool forTesting = false,
   }) async {

pkg/analyzer/pubspec.yaml

@@ -1,5 +1,5 @@
 name: analyzer
-version: 6.7.0
+version: 6.8.0-dev
 description: >-
   This package provides a library that performs static analysis of Dart code.
 repository: https://github.com/dart-lang/sdk/tree/main/pkg/analyzer