Template
chore: 初始化脚手架 — sunny_mochi 企业级 Flutter 模板
Core 基础设施：Flavor 三包体系、Drift+SQLCipher 加密数据库 7 拦截器 Dio 网络栈、CrashReporter 崩溃日志、Sealed Failure 错误体系 5 色板主题系统、Auth 认证骨架（Clean Architecture）、Dev Panel、Mock Adapter 通过验证：flutter analyze（0 errors）、flutter test（全绿）、staging APK 74.8MB
This commit is contained in:
SkyJourney
@@ -0,0 +1,43 @@
|
||||
import 'package:sunny_mochi/core/config/env.dart';
|
||||
|
||||
/// API 网络配置 — **baseUrl 决策的单一权威**
|
||||
///
|
||||
/// **对应 iOS BasicModule/Configuration/NetworkConfig.swift（2026-05 同步）**：
|
||||
///
|
||||
/// | 环境 | iOS apiBaseURL | Flutter ApiConfig.baseUrl |
|
||||
/// |------|---------------|--------------------------|
|
||||
/// | dev | http://192.168.1.201:24801 | 同 |
|
||||
/// | test | https://dev.yixiong-tech.com:8081 | 同 |
|
||||
/// | release | https://bac.new.hamkke.top | 同 |
|
||||
///
|
||||
/// **优先级**：
|
||||
/// 1. CI/CD / 临时调试通过 `--dart-define=API_BASE_URL=...` 注入 → 优先
|
||||
/// 2. 否则按 `Env.name`（dev/test/release）返回 iOS 同源 URL
|
||||
///
|
||||
/// **不再引入 h5BaseURL** — H5 评估报告已全部 Flutter 原生化（详见
|
||||
/// docs/h5-to-native-decision-2026-05-10.md），不再需要 in-app WebView。
|
||||
///
|
||||
/// **响应码请用 [ResponseCode]**（lib/core/network/response_code.dart）。
|
||||
/// **API 路径请用 [ApiPaths]**（lib/core/config/api_paths.dart）—
|
||||
/// 不允许 datasource 散落字面量。
|
||||
abstract class ApiConfig {
|
||||
/// API 网关 baseUrl — 与 iOS NetworkConfig.swift 同源
|
||||
static String get baseUrl {
|
||||
// 1. dart-define 覆盖优先（CI/CD / 临时切换私有环境）
|
||||
if (Env.apiBaseUrlOverride.isNotEmpty) {
|
||||
return Env.apiBaseUrlOverride;
|
||||
}
|
||||
// 2. 按 Env.name 返回 iOS 同源 URL
|
||||
return switch (Env.name) {
|
||||
'dev' => 'http://192.168.1.201:24801',
|
||||
'test' => 'https://dev.yixiong-tech.com:8081',
|
||||
'release' => 'https://bac.new.hamkke.top',
|
||||
_ => 'http://192.168.1.201:24801', // 默认 dev（与 iOS Debug 包一致）
|
||||
};
|
||||
}
|
||||
|
||||
// 网络超时 — 对应共性需求说明 §移动端 7.网络异常处理（10s 超时建议）
|
||||
static const Duration connectTimeout = Duration(seconds: 15);
|
||||
static const Duration receiveTimeout = Duration(seconds: 30);
|
||||
static const Duration sendTimeout = Duration(seconds: 30);
|
||||
}
|
||||
@@ -0,0 +1,72 @@
|
||||
/// API 路径常量（按微服务子系统分组）。
|
||||
///
|
||||
/// **零容忍规则**：所有 datasource 必须引用本文件常量；不允许字面量散落。
|
||||
///
|
||||
/// TODO: 填入项目 API 路径
|
||||
abstract class ApiPaths {
|
||||
// ============== Auth ==============
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String authLoginSms = '';
|
||||
static const String authLoginPwd = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String authSmsSend = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String authLogout = '';
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String authRefresh = '';
|
||||
|
||||
// ============== User / Mine ==============
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userProfile = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userChangePassword = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userIdCardVerify = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userPhoneList = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userPhoneAdd = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userPhoneDelete = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userPhoneVerifyCode = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userPhoneSetDefault = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userAvatarUpload = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userAvatarSetUrl = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userPasswordVerify = '';
|
||||
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String userPasswordReset = '';
|
||||
|
||||
// ============== Home ==============
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String homeBanner = '';
|
||||
|
||||
// ============== File ==============
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String fileUpload = '';
|
||||
|
||||
// ============== Error Report ==============
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String errorReport = '';
|
||||
|
||||
// ============== Crash Report ==============
|
||||
// TODO: 填入项目 API 路径
|
||||
static const String crashReport = '';
|
||||
}
|
||||
@@ -0,0 +1,109 @@
|
||||
import 'package:flutter/foundation.dart';
|
||||
import 'package:sentry_flutter/sentry_flutter.dart' show SentryFlutter;
|
||||
|
||||
/// 全局编译期环境配置。所有值通过 --dart-define 注入，避免明文 secrets。
|
||||
///
|
||||
/// **环境名与 iOS NetworkConfig.swift 对齐**：dev / test / release
|
||||
///
|
||||
/// 用法：
|
||||
/// ```bash
|
||||
/// # 开发环境 + mock（默认）
|
||||
/// flutter run --dart-define=ENV=dev --dart-define=USE_MOCK=true
|
||||
///
|
||||
/// # 测试环境（连真服 dev.yixiong-tech.com:8081）
|
||||
/// flutter run --dart-define=ENV=test
|
||||
///
|
||||
/// # 正式环境（连 bac.new.hamkke.top）
|
||||
/// flutter build apk --release --dart-define=ENV=release \
|
||||
/// --dart-define=SENTRY_DSN=https://...@sentry/1
|
||||
///
|
||||
/// # CI/CD 临时覆盖 API URL（不修改源码）
|
||||
/// flutter run --dart-define=API_BASE_URL=https://my-private.example.com
|
||||
/// ```
|
||||
///
|
||||
/// 详见：
|
||||
/// - `docs/flutter-architecture-design.md` §九.1 / §十一.5
|
||||
/// - `docs/real-environment-verification.md`（环境就绪后填值）
|
||||
/// - `lib/core/config/api_config.dart`（baseUrl 决策权威）
|
||||
abstract class Env {
|
||||
/// 当前环境名：**dev / test / release**（与 iOS NetworkConfig 三态对齐）。默认 dev。
|
||||
///
|
||||
/// - dev：开发环境（局域网 192.168.1.201:24801 / mock 模式可用）
|
||||
/// - test：测试环境（dev.yixiong-tech.com:8081 — 与 iOS test 同源）
|
||||
/// - release：正式环境（bac.new.hamkke.top — Release 包应锁定此值）
|
||||
static const String name = String.fromEnvironment('ENV', defaultValue: 'dev');
|
||||
|
||||
/// API baseUrl 临时覆盖（CI/CD / 私有环境调试用）。
|
||||
///
|
||||
/// **正常情况下不应使用此变量** — 让 [ApiConfig.baseUrl] 按 [name] 自动选择
|
||||
/// iOS 同源 URL。仅当需要连私有/临时环境时通过 dart-define 注入。
|
||||
///
|
||||
/// ```bash
|
||||
/// flutter run --dart-define=API_BASE_URL=https://my-private.example.com
|
||||
/// ```
|
||||
static const String apiBaseUrlOverride = String.fromEnvironment(
|
||||
'API_BASE_URL',
|
||||
);
|
||||
|
||||
/// Sentry DSN。**Q9 待答前**为空，[SentryFlutter.init] 自动跳过实际上报。
|
||||
static const String sentryDsn = String.fromEnvironment(
|
||||
'SENTRY_DSN',
|
||||
);
|
||||
|
||||
/// 是否为内部测试包（决定 TalkerScreen 调试面板是否挂载）。
|
||||
/// 详见 docs/real-environment-verification.md §M4 / §Talker 准入。
|
||||
static const bool isInternalBuild = bool.fromEnvironment(
|
||||
'INTERNAL_BUILD',
|
||||
);
|
||||
|
||||
/// 是否启用 mock fixtures 路径（绕过真实网络请求）。
|
||||
/// 详见 plan §Mock 与真实环境验证分层策略。
|
||||
static const bool useMock = bool.fromEnvironment(
|
||||
'USE_MOCK',
|
||||
);
|
||||
|
||||
/// 腾讯云 IM SDKAppID（数字 ID）。
|
||||
/// **Q3 待答前**为 0（无效值，init 会返回失败但不崩溃）。
|
||||
/// 沙箱测试用控制台测试 SDKAppID；生产用真实业务 SDKAppID。
|
||||
/// 注入：--dart-define=IM_SDK_APP_ID=1400xxxxxx
|
||||
static const int imSdkAppId = int.fromEnvironment(
|
||||
'IM_SDK_APP_ID',
|
||||
);
|
||||
|
||||
/// RSA 公钥（DER-SPKI Base64）— 用于登录密码加密。
|
||||
/// 默认值 = iOS dev 公钥（对应 platform-ios/.../RSAEncryption.swift 中的 publicKeyString）。
|
||||
/// 生产 / Q6 答复后通过 --dart-define=RSA_PUBLIC_KEY=... 注入真实公钥。
|
||||
static const String rsaPublicKey = String.fromEnvironment(
|
||||
'RSA_PUBLIC_KEY',
|
||||
defaultValue:
|
||||
'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCmZfR/bA9X3vp86y1aEpvwzXJYKRRF1fLau2+05/ZtaITLpV8bhkmSf3neSy/Q9gAdvG75Fr73E+GWE+K5b0BpvIS1jDGo319+PpZR39SaZTKZ27XFXrosmJTZutN79t819HS1VseleunHAFgMVufE9U5jP6LGzl/wbkSy01GhzwIDAQAB',
|
||||
);
|
||||
|
||||
/// TLS 证书绑定指纹列表（SHA-256，多指纹支持轮换）。
|
||||
/// **Q2 待答前**为空，CertificatePinningInterceptor 在空列表时跳过校验。
|
||||
/// 真实指纹通过 --dart-define=PINNED_FINGERPRINTS=AA:BB,CC:DD 注入。
|
||||
static List<String> get pinnedFingerprints {
|
||||
const raw = String.fromEnvironment(
|
||||
'PINNED_FINGERPRINTS',
|
||||
);
|
||||
if (raw.isEmpty) return const [];
|
||||
return raw
|
||||
.split(',')
|
||||
.map((s) => s.trim())
|
||||
.where((s) => s.isNotEmpty)
|
||||
.toList();
|
||||
}
|
||||
|
||||
// ---- 便捷判断（对齐 iOS NetworkConfig.Environment 三态）----
|
||||
static bool get isDev => name == 'dev';
|
||||
static bool get isTest => name == 'test';
|
||||
static bool get isRelease => name == 'release';
|
||||
|
||||
/// 兼容旧调用 — 历史代码可能用 isProd 判断
|
||||
/// @Deprecated 新代码请用 [isRelease]
|
||||
static bool get isProd => isRelease;
|
||||
|
||||
/// Release 包除非 INTERNAL_BUILD=true，否则视为生产模式。
|
||||
/// 用于 TalkerScreen / Riverpod observer 等开发面板的门控。
|
||||
static bool get enableDevPanel => kDebugMode || isInternalBuild;
|
||||
}
|
||||
Reference in New Issue
Block a user