Initial commit: 91dj android client dev_1.0.0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 11:37:25 +07:00
commit 97dd6a739a
1262 changed files with 119813 additions and 0 deletions
@@ -0,0 +1,84 @@
+/// API 配置管理类：统一管理所有 API 端点路径
+class ApiConfig {
+  ApiConfig._();
+
+  // ==================== API 路径（固定不变）====================
+
+  /// 上报接口路径（固定）
+  static const String defaultReportPath = '/api/eventTracking/batchReport.json';
+
+  /// 上报接口路径
+  static String get reportPath => defaultReportPath;
+
+  // ==================== 配置方法 ====================
+
+  /// 构建完整的 URL
+  /// [baseDomain] 基础域名，如 'https://api.example.com'
+  /// [path] API 路径，如 '/api/analytics/report'
+  /// [appId] 应用ID（可选），如果提供会作为查询参数添加到URL中
+  /// 返回完整的 URL，如 'https://api.example.com/api/analytics/report?appId=xxx'
+  static String buildUrl(String baseDomain, String path, {String? appId}) {
+    // 确保路径以 / 开头
+    final normalizedPath = _normalizePath(path);
+
+    // 解析基础域名
+    final uri = Uri.parse(baseDomain);
+    final scheme = uri.scheme.isEmpty ? 'https' : uri.scheme;
+    final host = uri.host.isEmpty ? baseDomain : uri.host;
+
+    // 保留非默认端口（如 :8080），避免 IP+端口 场景下端口丢失
+    final defaultPort = scheme == 'https' ? 443 : 80;
+    final portSuffix =
+        (uri.port > 0 && uri.port != defaultPort) ? ':${uri.port}' : '';
+
+    // 保留 baseDomain 中的路径前缀（如 /v2），仅在 host 成功解析时使用
+    // 去掉末尾 / 避免与 normalizedPath 拼出双斜杠
+    final basePath = uri.host.isNotEmpty && uri.path.isNotEmpty && uri.path != '/'
+        ? (uri.path.endsWith('/')
+            ? uri.path.substring(0, uri.path.length - 1)
+            : uri.path)
+        : '';
+
+    // 构建完整 URL
+    String url = '$scheme://$host$portSuffix$basePath$normalizedPath';
+
+    // 如果提供了 appId，添加到查询参数
+    if (appId != null && appId.isNotEmpty) {
+      url = _addQueryParameter(url, 'appId', appId);
+    }
+
+    return url;
+  }
+
+  /// 规范化路径：确保路径以 / 开头
+  static String _normalizePath(String path) {
+    if (path.isEmpty) {
+      return '/';
+    }
+    return path.startsWith('/') ? path : '/$path';
+  }
+
+  /// 获取上报接口 URL
+  /// [baseDomain] 基础域名
+  /// [appId] 应用ID（可选，如果提供会作为查询参数）
+  static String getReportUrl(String baseDomain, {String? appId}) {
+    return buildUrl(baseDomain, reportPath, appId: appId);
+  }
+
+  /// 添加查询参数到 URL
+  /// [url] 原始 URL
+  /// [key] 参数名
+  /// [value] 参数值
+  static String _addQueryParameter(String url, String key, String value) {
+    try {
+      final uri = Uri.parse(url);
+      final queryParams = Map<String, String>.from(uri.queryParameters);
+      queryParams[key] = value;
+      return uri.replace(queryParameters: queryParams).toString();
+    } catch (e) {
+      // 如果 URL 解析失败，直接拼接
+      final separator = url.contains('?') ? '&' : '?';
+      return '$url$separator$key=${Uri.encodeComponent(value)}';
+    }
+  }
+}