Template
SkyJourney
b8b63282ee
P0 代码修复：删除 imSdkAppId、清除内网 IP 与原项目域名、修正 USE_MOCK 默认值 P1 CLAUDE.md 重组：零容忍规则前置，新增 dart-defines 字段对照表 P2 文档优化：先跑再配的 setup 流程，新增 architecture.md 架构图
72 lines
3.3 KiB
Dart
72 lines
3.3 KiB
Dart
import 'package:flutter/foundation.dart';
|
||
|
||
/// 全局编译期环境配置。所有值通过 `--dart-define-from-file` 注入，明文 secrets 不入代码。
|
||
///
|
||
/// 三套环境对应 Flavor：
|
||
/// - `dev` → dev Flavor，开发调试（可开 Mock）
|
||
/// - `test` → staging Flavor，连测试服务器
|
||
/// - `release` → prod Flavor，正式发布
|
||
///
|
||
/// 用法：
|
||
/// ```bash
|
||
/// # 开发 + Mock（无需后端）
|
||
/// flutter run --flavor dev --dart-define-from-file=dart-defines/dev.json
|
||
///
|
||
/// # 临时覆盖 API URL（不修改源码）
|
||
/// flutter run --dart-define=API_BASE_URL=https://my-private.example.com
|
||
/// ```
|
||
///
|
||
/// **需要填写的字段**：见 dart-defines/dev.json（所有字段带 TODO 注释）
|
||
/// **API 路径**：见 lib/core/config/api_paths.dart
|
||
/// **baseUrl 决策**：见 lib/core/config/api_config.dart
|
||
abstract class Env {
|
||
/// 当前环境名：dev / test / release
|
||
static const String name = String.fromEnvironment(
|
||
'ENV',
|
||
defaultValue: 'dev',
|
||
);
|
||
|
||
/// API baseUrl 临时覆盖（CI/CD / 私有环境调试用）。
|
||
///
|
||
/// 正常情况下留空 — 由 [api_config.dart] 按 [name] 自动选择。
|
||
/// 仅当需要临时连私有/临时环境时通过 dart-define 注入：
|
||
/// `--dart-define=API_BASE_URL=https://my-private.example.com`
|
||
static const String apiBaseUrlOverride = String.fromEnvironment(
|
||
'API_BASE_URL',
|
||
);
|
||
|
||
/// Sentry DSN。空字符串时 SentryFlutter.init 自动跳过实际上报。
|
||
/// TODO: prod 环境通过 dart-defines/prod.json 填入真实 DSN。
|
||
static const String sentryDsn = String.fromEnvironment('SENTRY_DSN');
|
||
|
||
/// 是否为内部测试包（控制 Talker 调试面板入口是否挂载）。
|
||
static const bool isInternalBuild = bool.fromEnvironment('INTERNAL_BUILD');
|
||
|
||
/// 是否启用 Mock 模式（绕过真实网络，使用 assets/fixtures/ 下的 JSON）。
|
||
/// TODO: dev.json 默认 true，上线前确认 staging/prod 为 false。
|
||
static const bool useMock = bool.fromEnvironment('USE_MOCK');
|
||
|
||
/// RSA 公钥（DER-SPKI Base64）— 用于登录密码加密。
|
||
/// TODO: 从后端获取公钥后填入 dart-defines/*.json 的 RSA_PUBLIC_KEY 字段。
|
||
/// 若后端不需要 RSA 加密，可忽略此字段并移除 auth_repository_impl 中的加密逻辑。
|
||
static const String rsaPublicKey = String.fromEnvironment('RSA_PUBLIC_KEY');
|
||
|
||
/// TLS 证书绑定指纹列表（SHA-256，逗号分隔，支持多指纹轮换）。
|
||
/// TODO: 填入 PINNED_FINGERPRINTS 字段；dev 留空时 CertPinning 拦截器自动跳过。
|
||
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();
|
||
}
|
||
|
||
// ── 便捷判断 ──────────────────────────────────────────────────────────────
|
||
|
||
static bool get isDev => name == 'dev';
|
||
static bool get isTest => name == 'test';
|
||
static bool get isRelease => name == 'release';
|
||
|
||
/// Talker / Riverpod observer 等调试工具的门控。
|
||
/// Debug 包（flutter run）或 INTERNAL_BUILD=true 时开启。
|
||
static bool get enableDevPanel => kDebugMode || isInternalBuild;
|
||
}
|