[UA] Introduce flutterTrackAndroidDependencies (#2312)

Towards [181559](flutter/flutter#181559)

<details>
  <summary>Contribution guidelines:</summary><br>

- See our [contributor guide](https://github.com/dart-lang/.github/blob/main/CONTRIBUTING.md) for general expectations for PRs.
- Larger or significant changes should be discussed in an issue before creating a PR.
- Contributions to our repos should follow the [Dart style guide](https://dart.dev/guides/language/effective-dart) and use `dart format`.
- Most changes should add an entry to the changelog and may need to [rev the pubspec package version](https://github.com/dart-lang/sdk/blob/main/docs/External-Package-Maintenance.md#making-a-change).
- Changes to packages require [corresponding tests](https://github.com/dart-lang/.github/blob/main/CONTRIBUTING.md#Testing).

Many Dart repos have a weekly cadence for reviewing PRs - please allow for some latency before initial review feedback.

**Note**: The Dart team is trialing Gemini Code Assist. Don't take its comments as final Dart team feedback. Use the suggestions if they're helpful; otherwise, wait for a human reviewer.

</details>

Author: AbdeMohlbi

pkgs/unified_analytics/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 8.0.14
+- Added `Event.flutterTrackAndroidDependencies` to track android dependencies.
+
 ## 8.0.13
 - Deprecated `Event.flutterWasmDryRun` in favor of `Event.flutterWasmDryRunPackage`.
 

pkgs/unified_analytics/lib/src/constants.dart

@@ -87,7 +87,7 @@ const int kMaxLogFileSize = 25 * (1 << 20);
 const String kLogFileName = 'dart-flutter-telemetry.log';
 
 /// The current version of the package, should be in line with pubspec version.
-const String kPackageVersion = '8.0.13';
+const String kPackageVersion = '8.0.14';
 
 /// The minimum length for a session.
 const int kSessionDurationMinutes = 30;

pkgs/unified_analytics/lib/src/enums.dart

@@ -122,6 +122,12 @@ enum DashEvent {
     description: 'Information on plugins injected into an iOS/macOS project',
     toolOwner: DashTool.flutterTool,
   ),
+  flutterTrackAndroidDependencies(
+    label: 'flutter_android_dependencies',
+    description:
+        'Information related to min/target/compile SDK, JDK, NDK, Gradle version',
+    toolOwner: DashTool.flutterTool,
+  ),
   hotReloadTime(
     label: 'hot_reload_time',
     description: 'Hot reload duration',

pkgs/unified_analytics/lib/src/event.dart

@@ -764,6 +764,47 @@ final class Event {
           },
         );
 
+  /// Provides information about the android dependencies of a project.
+  ///
+  /// * [isModule] - whether the project is an add-to-app Flutter module.
+  ///
+  /// * [agpVersion] - the Android Gradle plugin of the build target.
+  ///
+  /// * [minSDK] - the minimum SDK version supported by the build target.
+  ///
+  /// * [targetSDK] - the target SDK version the build target is built against.
+  ///
+  /// * [compileSDK] - the compile SDK version the build target is built
+  /// against.
+  ///
+  /// * [jdkVersion] - the JDK version used by the build target.
+  ///
+  /// * [ndkVersion] - the NDK version used by the build target.
+  ///
+  /// * [gradleVersion] - the Gradle version used by the build target.
+  Event.flutterTrackAndroidDependencies({
+    bool? isModule,
+    String? agpVersion,
+    int? minSDK,
+    int? targetSDK,
+    int? compileSDK,
+    int? jdkVersion,
+    String? ndkVersion,
+    String? gradleVersion,
+  }) : this._(
+          eventName: DashEvent.flutterTrackAndroidDependencies,
+          eventData: {
+            if (isModule != null) 'isModule': isModule,
+            if (agpVersion != null) 'agpVersion': agpVersion,
+            if (minSDK != null) 'minSDK': minSDK,
+            if (targetSDK != null) 'targetSDK': targetSDK,
+            if (compileSDK != null) 'compileSDK': compileSDK,
+            if (jdkVersion != null) 'jdkVersion': jdkVersion,
+            if (ndkVersion != null) 'ndkVersion': ndkVersion,
+            if (gradleVersion != null) 'gradleVersion': gradleVersion,
+          },
+        );
+
   // TODO: eliasyishak, remove this or replace once we have a generic
   //  timing event that can be used by potentially more than one DashTool.
   Event.hotReloadTime({required int timeMs})

pkgs/unified_analytics/pubspec.yaml

@@ -5,7 +5,7 @@ description: >-
 # LINT.IfChange
 # When updating this, keep the version consistent with the changelog and the
 # value in lib/src/constants.dart.
-version: 8.0.13
+version: 8.0.14
 # LINT.ThenChange(lib/src/constants.dart)
 repository: https://github.com/dart-lang/tools/tree/main/pkgs/unified_analytics
 issue_tracker: https://github.com/dart-lang/tools/issues?q=is%3Aissue+is%3Aopen+label%3Apackage%3Aunified_analytics

pkgs/unified_analytics/test/event_test.dart

@@ -530,6 +530,60 @@ void main() {
     expect(constructedEvent.eventData.length, 9);
   });
 
+  group('Event.flutterTrackAndroidDependencies', () {
+    test('constructed', () {
+      Event generateEvent() => Event.flutterTrackAndroidDependencies(
+            isModule: true,
+            agpVersion: '8.2.2',
+            minSDK: 24,
+            targetSDK: 36,
+            compileSDK: 36,
+            jdkVersion: 24,
+            ndkVersion: '28.0.13004108',
+            gradleVersion: '8.10.2',
+          );
+
+      final constructedEvent = generateEvent();
+
+      expect(generateEvent, returnsNormally);
+      expect(constructedEvent.eventName,
+          DashEvent.flutterTrackAndroidDependencies);
+      expect(constructedEvent.eventData['isModule'], isTrue);
+      expect(constructedEvent.eventData['agpVersion'], '8.2.2');
+      expect(constructedEvent.eventData['minSDK'], 24);
+      expect(constructedEvent.eventData['targetSDK'], 36);
+      expect(constructedEvent.eventData['compileSDK'], 36);
+      expect(constructedEvent.eventData['jdkVersion'], 24);
+      expect(constructedEvent.eventData['ndkVersion'], '28.0.13004108');
+      expect(constructedEvent.eventData['gradleVersion'], '8.10.2');
+      expect(constructedEvent.eventData.length, 8);
+    });
+
+    test('constructor arguments default to null if not specified', () {
+      Event generateEvent() => Event.flutterTrackAndroidDependencies(
+            isModule: true,
+            agpVersion: '8.2.2',
+            targetSDK: 36,
+            jdkVersion: 24,
+            gradleVersion: '8.10.2',
+          );
+
+      final constructedEvent = generateEvent();
+
+      expect(generateEvent, returnsNormally);
+      expect(constructedEvent.eventName,
+          DashEvent.flutterTrackAndroidDependencies);
+      expect(constructedEvent.eventData['isModule'], isTrue);
+      expect(constructedEvent.eventData['agpVersion'], '8.2.2');
+      expect(constructedEvent.eventData['minSDK'], null);
+      expect(constructedEvent.eventData['targetSDK'], 36);
+      expect(constructedEvent.eventData['compileSDK'], null);
+      expect(constructedEvent.eventData['jdkVersion'], 24);
+      expect(constructedEvent.eventData['ndkVersion'], null);
+      expect(constructedEvent.eventData['gradleVersion'], '8.10.2');
+      expect(constructedEvent.eventData.length, 5);
+    });
+  });
   test('Event.codeSizeAnalysis constructed', () {
     Event generateEvent() => Event.codeSizeAnalysis(platform: 'platform');
 
@@ -785,7 +839,7 @@ void main() {
 
     // Change this integer below if your PR either adds or removes
     // an Event constructor
-    final eventsAccountedForInTests = 33;
+    final eventsAccountedForInTests = 34;
     expect(eventsAccountedForInTests, constructorCount,
         reason: 'If you added or removed an event constructor, '
             'ensure you have updated '