fix(ci): 测试改用 TDESIGN_COMPONENT_ROOT，先 clone 再跑单测

CI 上 8 个测试失败因硬编码本地绝对路径；统一通过环境变量解析 tdesign-component 路径。

Author: RSS1102

.github/workflows/api-compliance.yml

@@ -43,7 +43,14 @@ jobs:
       - name: 静态分析 tools
         run: dart analyze --fatal-infos
 
+      - name: 克隆 tdesign-flutter（测试与 validate 共用）
+        run: |
+          git clone --depth 1 --branch "${FLUTTER_BRANCH}" \
+            https://github.com/Tencent/tdesign-flutter.git "${FLUTTER_REPO}"
+
       - name: 单元测试（完备性相关）
+        env:
+          TDESIGN_COMPONENT_ROOT: ${{ github.workspace }}/${{ env.FLUTTER_REPO }}/tdesign-component
         run: |
           dart test test/aux_types_test.dart \
                    test/ctor_defaults_test.dart \
@@ -52,11 +59,6 @@ jobs:
                    test/enum_members_test.dart \
                    test/positional_ctor_test.dart
 
-      - name: 克隆 tdesign-flutter（只读，用于读取已提交的 *_api.md）
-        run: |
-          git clone --depth 1 --branch "${FLUTTER_BRANCH}" \
-            https://github.com/Tencent/tdesign-flutter.git "${FLUTTER_REPO}"
-
       - name: 运行 AST 完备性检测（非零 exit code 即失败）
         run: |
           dart run bin/main.dart validate \

test/aux_types_test.dart

@@ -4,7 +4,10 @@ import 'package:analyzer/file_system/physical_file_system.dart';
 import 'package:tdesign_flutter_tools/component_rule.dart';
 import 'package:test/test.dart';
 
-List<dynamic> _analyse(List<String> names, String path) {
+import 'support/component_paths.dart';
+
+List<dynamic> _analyse(List<String> names, String relPath) {
+  final String path = componentSourcePath(relPath);
   final col = AnalysisContextCollection(
     includedPaths: [path],
     resourceProvider: PhysicalResourceProvider.INSTANCE,
@@ -16,15 +19,16 @@ List<dynamic> _analyse(List<String> names, String path) {
     isGrammarParser: false,
     nameList: names,
     folderName: 'popup',
-    sourceFileName: path.split('/').last,
+    sourceFileName: relPath.split('/').last,
   ).analyse();
 }
 
 void main() {
   test('auto includes SlideTransitionFrom when parsing TSlidePopupRoute file', () {
-    final path =
-        '/Users/rs/Documents/cursor/tdesign-flutter/tdesign-component/lib/src/components/popup/t_popup_route.dart';
-    final list = _analyse(['TSlidePopupRoute'], path);
+    final list = _analyse(
+      ['TSlidePopupRoute'],
+      'lib/src/components/popup/t_popup_route.dart',
+    );
     final names = list.map((e) => e.componentInfo!.name).toList();
     expect(names, contains('SlideTransitionFrom'));
     final enumInfo =
@@ -35,9 +39,10 @@ void main() {
   });
 
   test('auto includes PopupClick when parsing popup panel file', () {
-    final path =
-        '/Users/rs/Documents/cursor/tdesign-flutter/tdesign-component/lib/src/components/popup/t_popup_panel.dart';
-    final list = _analyse(['TPopupBottomDisplayPanel'], path);
+    final list = _analyse(
+      ['TPopupBottomDisplayPanel'],
+      'lib/src/components/popup/t_popup_panel.dart',
+    );
     final names = list.map((e) => e.componentInfo!.name).toList();
     expect(names, contains('PopupClick'));
     final typedefInfo =

test/ctor_defaults_test.dart

@@ -4,9 +4,11 @@ import 'package:analyzer/file_system/physical_file_system.dart';
 import 'package:tdesign_flutter_tools/component_rule.dart';
 import 'package:test/test.dart';
 
+import 'support/component_paths.dart';
+
 List<dynamic> _analyse(List<String> names) {
-  final path =
-      '/Users/rs/Documents/cursor/tdesign-flutter/tdesign-component/lib/src/components/popup/t_popup_panel.dart';
+  const String relPath = 'lib/src/components/popup/t_popup_panel.dart';
+  final String path = componentSourcePath(relPath);
   final col = AnalysisContextCollection(
     includedPaths: [path],
     resourceProvider: PhysicalResourceProvider.INSTANCE,

test/enum_members_test.dart

@@ -5,11 +5,10 @@ import 'package:tdesign_flutter_tools/component_rule.dart';
 import 'package:tdesign_flutter_tools/model.dart';
 import 'package:test/test.dart';
 
-const String _componentRoot =
-    '/Users/rs/Documents/cursor/tdesign-flutter/tdesign-component';
+import 'support/component_paths.dart';
 
 List<ParsedComponentInfoInfo> _analyse(List<String> names, String relPath) {
-  final path = '$_componentRoot/$relPath';
+  final String path = componentSourcePath(relPath);
   final col = AnalysisContextCollection(
     includedPaths: [path],
     resourceProvider: PhysicalResourceProvider.INSTANCE,

test/factory_ctor_test.dart

@@ -5,11 +5,10 @@ import 'package:tdesign_flutter_tools/component_rule.dart';
 import 'package:tdesign_flutter_tools/model.dart';
 import 'package:test/test.dart';
 
-const String _componentRoot =
-    '/Users/rs/Documents/cursor/tdesign-flutter/tdesign-component';
+import 'support/component_paths.dart';
 
 List<ParsedComponentInfoInfo> _analyse(List<String> names, String relPath) {
-  final path = '$_componentRoot/$relPath';
+  final String path = componentSourcePath(relPath);
   final col = AnalysisContextCollection(
     includedPaths: [path],
     resourceProvider: PhysicalResourceProvider.INSTANCE,

test/positional_ctor_test.dart

@@ -5,11 +5,10 @@ import 'package:tdesign_flutter_tools/component_rule.dart';
 import 'package:tdesign_flutter_tools/model.dart';
 import 'package:test/test.dart';
 
-const String _componentRoot =
-    '/Users/rs/Documents/cursor/tdesign-flutter/tdesign-component';
+import 'support/component_paths.dart';
 
 List<ParsedComponentInfoInfo> _analyse(List<String> names, String relPath) {
-  final path = '$_componentRoot/$relPath';
+  final String path = componentSourcePath(relPath);
   final col = AnalysisContextCollection(
     includedPaths: [path],
     resourceProvider: PhysicalResourceProvider.INSTANCE,
@@ -38,7 +37,6 @@ void main() {
     expect(contextParam.isNamed, isFalse);
     expect(contextParam.type, 'BuildContext');
 
-    // positional 参数排在命名参数之前
     final firstParam = info.propertyList.first;
     expect(firstParam.name, 'context');
     expect(firstParam.isNamed, isFalse);

test/support/component_paths.dart

@@ -0,0 +1,31 @@
+import 'dart:io';
+
+import 'package:path/path.dart' as p;
+
+/// tdesign-component 根目录。
+/// CI 通过环境变量 `TDESIGN_COMPONENT_ROOT` 注入；本地默认可用 ../tdesign-flutter/tdesign-component。
+String get tdesignComponentRoot {
+  final String? fromEnv = Platform.environment['TDESIGN_COMPONENT_ROOT'];
+  if (fromEnv != null && fromEnv.isNotEmpty) {
+    return p.normalize(fromEnv);
+  }
+
+  final List<String> candidates = <String>[
+    p.normalize(
+      p.join(Directory.current.path, '../tdesign-flutter/tdesign-component'),
+    ),
+  ];
+  for (final String candidate in candidates) {
+    if (Directory(candidate).existsSync()) {
+      return candidate;
+    }
+  }
+
+  throw StateError(
+    '未找到 tdesign-component。请 clone tdesign-flutter 或设置 TDESIGN_COMPONENT_ROOT。',
+  );
+}
+
+String componentSourcePath(String relativePath) {
+  return p.join(tdesignComponentRoot, relativePath);
+}