ttipo/arasystem
1
0
Fork 0
generated from ttipo/project-base
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

feat(flutter): [새 버전 받기]를 포털 받기 화면으로 바꾸고 release 는 우리 키 · 운영 주소로만 만든다

Browse Source 
스토어에 올리지 않으니 업데이트 화면의 Play 스토어 열기를 포털 /app 을 바깥 브라우저로 여는 것으로 바꾸고,
설정 › 앱 정보에도 같은 줄을 더했다. release 빌드는 우리 서명 키(key.properties) · google-services.json ·
운영 포털의 https API 주소가 갖춰지지 않으면 까닭을 알리고 멈춘다 — debug 키로 조용히 서명되거나
개발 주소가 든 판이 직원에게 나가지 않게(알리는 글에 주소 값은 싣지 않는다).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
ttipo
2026-11-08 23:29:05 +09:00
parent 433ef12cc3
commit e9acb7809c
17 changed files with 755 additions and 173 deletions
Download Patch File Download Diff File Expand all files Collapse all files
flutter/android/app/build.gradle.kts
+174 -11
View File
@@ -1,3 +1,8 @@
import java.net.InetAddress
import java.net.URI
import java.net.URISyntaxException
import java.util.Properties
plugins {
id("com.android.application")
id("kotlin-android")
@@ -5,6 +10,137 @@ plugins {
id("dev.flutter.flutter-gradle-plugin")
}
// 배포 판(release)의 서명 — 우리 서명 키로만 한다(앱은 스토어에 올리지 않고 사내에 직접 나눠 준다 — flutter/README "사내 배포").
// android/key.properties(storeFile · storePassword · keyAlias · keyPassword)가 저장소 밖의 keystore 를 가리킨다.
// key.properties · keystore 는 커밋하지 않는다(android/.gitignore). 값(비밀번호)은 어떤 오류 글에도 싣지 않는다.
// 키가 갖춰지지 않았으면 release 작업을 멈춘다(맨 아래 확인) — flutter create 기본처럼 debug 키로 조용히 서명하면,
// 그 판을 깐 휴대폰에는 우리 키로 서명한 다음 판을 덮어 설치할 수 없다(앱을 지우고 다시 설치해야 한다).
val keystorePropertiesFile = rootProject.file("key.properties")
val keystoreProperties = Properties()
val releaseSigningProblem: String? = run {
if (!keystorePropertiesFile.isFile) return@run "android/key.properties 가 없습니다."
try {
keystorePropertiesFile.inputStream().use { keystoreProperties.load(it) }
} catch (e: Exception) {
// .properties 는 \ 를 이스케이프로 읽는다 — Windows 경로의 \u… 는 여기서 실패한다
return@run "android/key.properties 를 읽지 못했습니다. 경로의 \\ 는 / 로 적어 주세요."
}
val blank = listOf("storeFile", "storePassword", "keyAlias", "keyPassword")
.filter { keystoreProperties.getProperty(it).isNullOrBlank() }
if (blank.isNotEmpty()) {
return@run "android/key.properties 에 비어 있는 칸이 있습니다: ${blank.joinToString(", ")}."
}
// 상대 경로는 android/ 기준(key.properties 가 있는 곳)이다 — 절대 경로로 적기를 권한다
if (!rootProject.file(keystoreProperties.getProperty("storeFile").trim()).isFile) {
return@run "android/key.properties 의 storeFile 이 가리키는 keystore 파일이 없습니다. 경로의 \\ 는 / 로 적어 주세요."
}
null
}
// ── 배포 판의 API 주소 판정 (순수 함수 — 아래 releaseApiUrlProblem 이 부른다) ──
// 앱 안에 그대로 들어가는 flutter/.env(pubspec 의 asset)의 API_URL 을 앱과 같은 규칙으로 읽고, 운영 포털의 API 주소인지 본다.
// Gradle 스크립트라 저장소의 시험(flutter test · CI 는 Gradle 을 돌리지 않는다)으로는 돌리지 못한다 — 고치면 flutter/README "사내 배포 › 4. release 빌드" 의
// 확인(키 없이 · 개발 주소인 채로 `flutter build apk --release`)으로 다시 본다. 판정 글에는 주소 값을 싣지 않는다(무엇이 틀렸는지만).
/** 앱이 읽는 키 — 짝: Dart `lib/core/api/api_config.dart` 의 `kApiUrlEnvKey`(없으면 앱은 개발 주소 `kDefaultApiUrl` 로 돈다) */
val apiUrlEnvKey = "API_URL"
private val dotenvComment = Regex("""#[^'"]*$""")
private val dotenvCommentWithQuotes = Regex("""#.*$""")
private val dotenvLeadingExport = Regex("""^ *export ?""")
private val dotenvSurroundQuotes = Regex("""^(["'])(.*?[^\\])\1""")
private val dotenvBashVar = Regex("""(\\)?(\$)(?:\{)?([a-zA-Z_][\w]*)+(?:\})?""")
/** Dart 의 `String.trim` — 공백과 함께 BOM(U+FEFF)도 뗀다 */
fun dartTrim(text: String): String = text.trim { it.isWhitespace() || it == '\uFEFF' }
/**
* flutter_dotenv 5.2.1 의 `Parser.parse` 를 옮겼다 — 앱이 `.env` 를 읽는 규칙 그대로(줄은 `\n` 으로만 나눈다).
* 같은 키는 처음 것, 따옴표 밖의 `#` 주석 · 앞의 `export` · 둘러싼 따옴표를 떼고, 홑따옴표가 아니면 앞에서 읽은 `$이름` 을 채운다.
* 짝: `pubspec.lock` 의 flutter_dotenv 판 — 판을 올리면 그 판의 `lib/src/parser.dart` 와 다시 견준다
*/
fun parseDotenv(lines: List<String>): Map<String, String> {
val out = LinkedHashMap<String, String>()
for (line in lines) {
val stripped = dartTrim(line.replace(dotenvComment, ""))
if (stripped.isEmpty() || !stripped.contains('=')) continue
val idx = stripped.indexOf('=')
val key = dartTrim(stripped.substring(0, idx).replace(dotenvLeadingExport, ""))
if (key.isEmpty()) continue
val rhs = dartTrim(stripped.substring(idx + 1))
val quoted = dotenvSurroundQuotes.find(rhs)
val quote = quoted?.groupValues?.get(1).orEmpty()
var value = quoted?.groupValues?.get(2) ?: dartTrim(dartTrim(rhs.replace(dotenvCommentWithQuotes, "")))
if (quote == "'") {
value = value.replace("\\'", "'")
} else {
if (quote == "\"") value = value.replace("\\\"", "\"").replace("\\n", "\n")
value = dotenvBashVar.replace(value) { m ->
if (m.groupValues[1] == "\\") m.value else out[m.groupValues[3]].orEmpty()
}.replace("\\\$", "\$")
}
out.putIfAbsent(key, value)
}
return out
}
/**
* 개발 주소 — localhost · `.localhost` · `.test` 로 끝나는 이름 · 루프백(127.0.0.0/8 · ::1) · 0.0.0.0 · 안드로이드 에뮬레이터의 PC 주소 10.0.2.2.
* [host] 는 소문자 · 대괄호 없이 받는다. IPv6 는 IP 글자일 때만 읽는다(이름을 묻지 않는다 — DNS 없음)
*/
fun isDevelopmentHost(host: String): Boolean {
if (host == "localhost" || host.endsWith(".localhost") || host.endsWith(".test")) return true
if (host == "10.0.2.2" || host == "0.0.0.0") return true
if (Regex("""127(\.\d{1,3}){3}""").matches(host)) return true
if (!host.contains(':')) return false
return try {
InetAddress.getByName(host).let { it.isLoopbackAddress || it.isAnyLocalAddress }
} catch (e: Exception) {
false
}
}
/** API 주소의 경로로 받는 것 — 같은 주소 배포라 늘 포털 출처의 `/api`(끝의 `/` 하나까지) */
val releaseApiPaths = setOf("/api", "/api/")
/**
* 배포 판에 넣을 API 주소의 문제 — 없으면 null. 운영 포털의 API 주소(`https://<포털>/api`)여야 한다:
* 앞뒤 빈칸 없음(앱은 파서가 준 값을 그대로 쓴다 — 따옴표 안의 빈칸은 파서가 떼지 않는다) · https · 개발 주소 아님 ·
* 사용자 정보 · 쿼리 · 조각 없음(APK 안의 .env 는 누구나 풀어 볼 수 있고, 사용자 정보는 dart:io 가 Basic 으로 보낸다) · 경로 `/api`.
* 글은 고정 글이다 — 주소 값을 싣지 않는다(무엇이 틀렸는지만)
*/
fun apiUrlProblemForRelease(apiUrl: String?): String? {
if (apiUrl.isNullOrEmpty()) return "flutter/.env 에 API_URL 이 없습니다."
if (apiUrl != dartTrim(apiUrl)) return "flutter/.env 의 API_URL 값 앞뒤에 빈칸이 있습니다."
val uri = try {
URI(apiUrl)
} catch (e: URISyntaxException) {
return "flutter/.env 의 API_URL 을 주소로 읽지 못했습니다."
}
if (!uri.scheme.equals("https", ignoreCase = true)) return "flutter/.env 의 API_URL 이 https 주소가 아닙니다."
val host = uri.host.orEmpty().removePrefix("[").removeSuffix("]").trimEnd('.').lowercase()
if (host.isEmpty()) return "flutter/.env 의 API_URL 에서 호스트를 읽지 못했습니다."
if (isDevelopmentHost(host)) return "flutter/.env 의 API_URL 이 개발 주소입니다."
if (uri.rawUserInfo != null || uri.rawQuery != null || uri.rawFragment != null) {
return "flutter/.env 의 API_URL 에 사용자 정보 · 쿼리 · 조각이 있습니다."
}
if (uri.rawPath !in releaseApiPaths) return "flutter/.env 의 API_URL 경로가 /api 가 아닙니다."
return null
}
// ── 배포 판의 API 주소 판정 끝 ──
// 앱에 들어갈 .env 를 지금 읽는다(Flutter 가 같은 파일을 asset 으로 싣는다). 없거나 읽지 못해도 release 를 막는다 — 값이 없으면 앱은 개발 주소로 돈다
val appEnvFile = rootProject.file("../.env")
val releaseApiUrlProblem: String? = if (!appEnvFile.isFile) {
"flutter/.env 가 없습니다."
} else {
try {
apiUrlProblemForRelease(parseDotenv(appEnvFile.readText(Charsets.UTF_8).split("\n"))[apiUrlEnvKey])
} catch (e: Exception) {
"flutter/.env 를 읽지 못했습니다."
}
}
android {
namespace = "kr.it.arasystem.app"
compileSdk = flutter.compileSdkVersion
@@ -30,11 +166,22 @@ android {
versionName = flutter.versionName
}
signingConfigs {
// 키가 갖춰졌을 때만 만든다 — 빈 값으로 만들면 debug 빌드까지 설정 단계에서 실패한다
if (releaseSigningProblem == null) {
create("release") {
storeFile = rootProject.file(keystoreProperties.getProperty("storeFile").trim())
storePassword = keystoreProperties.getProperty("storePassword")
keyAlias = keystoreProperties.getProperty("keyAlias").trim()
keyPassword = keystoreProperties.getProperty("keyPassword")
}
}
}
buildTypes {
release {
// TODO: Add your own signing config for the release build.
// Signing with the debug keys for now, so `flutter run --release` works.
signingConfig = signingConfigs.getByName("debug")
// 우리 키 — 갖춰지지 않았으면 null(서명 없음)이고, 맨 아래 확인이 release 작업을 멈춘다
signingConfig = signingConfigs.findByName("release")
}
}
}
@@ -45,19 +192,35 @@ flutter {
// 새 메일 알림(FCM)의 Firebase 설정 — android/app/google-services.json 은 저장소에 넣지 않는다(android/.gitignore · flutter/README "새 메일 알림").
// 있으면 google-services 플러그인이 리소스로 바꾸고(Dart 의 Firebase.initializeApp 이 읽는다), 없으면 알림 없이 빌드한다 — 앱은 "받을 수 없는 휴대폰"으로 돈다.
// 배포 판(release 변형)을 만드는 작업이 하나라도 있으면 멈춘다 — 새 메일 알림 없이 나가지 않게.
// 부른 작업 이름이 아니라 실행할 작업 그래프를 본다: assembleRelease · bundleRelease 뿐 아니라 모든 변형을 만드는 assemble · bundle · build,
// 줄여 쓴 이름(aR)도 이 프로젝트의 release 작업(이름에 Release 가 든다)을 그래프에 넣는다.
// debug · release 를 다른 Firebase 프로젝트로 나누려면(app/src/debug · app/src/release 에 따로 둔다) 이 조건도 함께 바꾼다.
// debug · release 를 다른 Firebase 프로젝트로 나누려면(app/src/debug · app/src/release 에 따로 둔다) 아래 확인의 조건도 함께 바꾼다.
val firebaseConfig = file("google-services.json")
if (firebaseConfig.exists()) {
apply(plugin = "com.google.gms.google-services")
} else {
}
// 배포 판(release 변형)에 갖출 것 — 하나라도 빠졌으면 release 작업이 하나라도 있을 때 멈추고, 빠진 것을 한 번에 알린다.
// - google-services.json: 새 메일 알림 없이 나가지 않게
// - 우리 서명 키(key.properties): debug 키로 서명한 판이 나가지 않게(위 releaseSigningProblem)
// - 운영 API 주소(flutter/.env 의 API_URL): 개발 주소 · http 로 만든 판이 나가지 않게(위 releaseApiUrlProblem — 글에 주소 값을 싣지 않는다)
// 부른 작업 이름이 아니라 실행할 작업 그래프를 본다: assembleRelease · bundleRelease 뿐 아니라 모든 변형을 만드는 assemble · bundle · build,
// 줄여 쓴 이름(aR)도 이 프로젝트의 release 작업(이름에 Release 가 든다)을 그래프에 넣는다. debug · profile 빌드는 그대로 된다.
val releaseBlockers: List<String> = listOfNotNull(
if (firebaseConfig.exists()) {
null
} else {
"android/app/google-services.json 이 없습니다. 배포 판은 새 메일 알림 없이 나가지 않습니다 (flutter/README \"새 메일 알림\")."
},
releaseSigningProblem?.let {
"$it 배포 판은 우리 서명 키로만 서명합니다 (flutter/README \"사내 배포\")."
},
releaseApiUrlProblem?.let {
"$it 배포 판은 운영 포털의 API 주소로만 만듭니다 (flutter/README \"사내 배포\")."
},
)
if (releaseBlockers.isNotEmpty()) {
gradle.taskGraph.whenReady {
if (allTasks.any { it.project == project && it.name.contains("Release") }) {
throw GradleException(
"android/app/google-services.json 이 없습니다. 배포 판은 새 메일 알림 없이 나가지 않습니다 (flutter/README \"새 메일 알림\").",
)
throw GradleException(releaseBlockers.joinToString("\n"))
}
}
}
flutter/lib/core/api/user_agent.dart
+2 -12
View File
@@ -44,23 +44,14 @@ String _clean(String? value) {
: kept;
}
/// 이 기기의 앱 판 · 패키지 이름(업데이트 화면의 Play 스토어 주소) · User-Agent · 안드로이드 판(API — 새 메일 알림의 권한을 가른다) — main 에서 한 번.
/// 이 기기의 앱 판 · User-Agent · 안드로이드 판(API — 새 메일 알림의 권한을 가른다) — main 에서 한 번.
/// 기기 정보를 읽지 못하면 아는 것만 싣는다.
Future<
({
String? appVersion,
String? packageName,
String userAgent,
int? androidSdkInt,
})
>
Future<({String? appVersion, String userAgent, int? androidSdkInt})>
loadAppDeviceInfo() async {
String? appVersion;
String? packageName;
try {
final PackageInfo info = await PackageInfo.fromPlatform();
appVersion = info.version;
packageName = info.packageName.isEmpty ? null : info.packageName;
} on PlatformException {
appVersion = null;
}
@@ -69,7 +60,6 @@ loadAppDeviceInfo() async {
);
return (
appVersion: appVersion,
packageName: packageName,
userAgent: device.userAgent,
androidSdkInt: device.androidSdkInt,
);
flutter/lib/core/app_download/app_download_launcher.dart
+73
View File
@@ -0,0 +1,73 @@
import 'package:arasystem_app/core/api/dio_provider.dart';
import 'package:arasystem_app/core/app_download/app_download_link.dart';
import 'package:arasystem_app/core/app_download/app_download_texts.dart';
import 'package:arasystem_app/shared/widgets/keep_all_text.dart';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:url_launcher/url_launcher.dart';
/// 다른 앱으로 주소를 넘기는 함수 — 기본은 url_launcher 의 [launchUrl]. 시험은 가짜를 넣는다
typedef AppDownloadLaunch = Future<bool> Function(Uri url, LaunchMode mode);
Future<bool> _launchExternal(Uri url, LaunchMode mode) =>
launchUrl(url, mode: mode);
/// [새 버전 받기] — 포털의 휴대폰 앱 받기 화면(`app_download_link.dart`)을 바깥 브라우저로 연다.
/// 업데이트 화면과 설정 › 앱 정보가 이 런처 하나를 함께 쓴다(같은 주소 · 같은 실패 알림).
///
/// - 바깥 앱(`LaunchMode.externalApplication` — 휴대폰의 기본 브라우저)으로 연다. 받기 화면은 로그인한 직원만 받으므로
/// 브라우저의 웹메일 로그인을 쓴다(앱의 토큰은 넘기지 않는다).
/// - `canLaunchUrl` 은 쓰지 않는다(debug 판 안드로이드가 묻는 주소를 로그에 남긴다 — 인증 앱 열기와 같은 규칙).
/// 못 열면 플러그인 예외를 버리고 거짓 — 화면이 [failureMessage] 를 알린다
class AppDownloadLauncher {
AppDownloadLauncher({
required String apiBaseUrl,
AppDownloadLaunch launch = _launchExternal,
}) : pageUrl = appDownloadPageUrlOf(apiBaseUrl),
_launch = launch;
/// 받기 화면 주소 — 앱의 API 주소로 만들지 못했으면 null(열지 않고 알린다)
final Uri? pageUrl;
final AppDownloadLaunch _launch;
/// 열었으면 참
Future<bool> open() async {
final Uri? url = pageUrl;
if (url == null) return false;
try {
return await _launch(url, LaunchMode.externalApplication);
} on Object {
// PlatformException(받을 앱 없음 · 화면 없음) 등 — 화면은 주소를 알려 직접 들어가게 한다
return false;
}
}
/// 열지 못했을 때의 알림 글 — 직원이 브라우저에 직접 넣을 주소(스킴 없이)를 담는다
String get failureMessage {
final Uri? url = pageUrl;
return url == null
? AppDownloadTexts.openFailedNoAddress
: AppDownloadTexts.openFailed(appDownloadPageAddressOf(url));
}
}
/// 받기 화면 런처 — 앱의 API 주소(`apiConfigProvider`)로 주소를 만든다. 시험은 가짜로 덮어쓴다
final Provider<AppDownloadLauncher> appDownloadLauncherProvider =
Provider<AppDownloadLauncher>(
(Ref ref) =>
AppDownloadLauncher(apiBaseUrl: ref.watch(apiConfigProvider).baseUrl),
);
/// [새 버전 받기]를 누른 뒤 — 받기 화면을 열고, 열지 못하면 주소를 담아 알린다(두 화면이 같은 알림을 쓴다).
/// [messenger] 는 누른 화면에서 기다리기 전에 잡아 둔다(브라우저가 뜨는 동안 화면이 바뀔 수 있다)
Future<void> openAppDownloadPage(
WidgetRef ref,
ScaffoldMessengerState messenger,
) async {
final AppDownloadLauncher launcher = ref.read(appDownloadLauncherProvider);
if (await launcher.open()) return;
messenger
..hideCurrentSnackBar()
..showSnackBar(SnackBar(content: KeepAllText(launcher.failureMessage)));
}
flutter/lib/core/app_download/app_download_link.dart
+30
View File
@@ -0,0 +1,30 @@
/// 포털의 휴대폰 앱 받기 화면 주소 — 앱을 스토어에 올리지 않고 사내에서 직접 나눠 주는 곳(2026-11-08).
/// 앱의 업데이트 화면 · 설정 › 앱 정보의 [새 버전 받기]가 이 주소를 바깥 브라우저로 연다(앱 보드 `App1Push` ⑩ · ④).
///
/// 같은 주소 배포라 앱의 API 주소(`.env` 의 `API_URL` — `ApiConfig.baseUrl`)는 늘 포털 출처의 `/api` 다.
/// 그래서 받는 곳 주소를 서버에서 받지 않고(앱 설정 계약은 싣지 않는다) API 주소의 출처에 받기 화면 경로를 붙여 만든다.
library;
/// 받기 화면 경로 — 짝: 웹 `frontend/src/shared/constants/mobile-app.ts` 의 `MOBILE_APP_PATH`(한쪽을 바꾸면 둘 다)
const String kAppDownloadPagePath = '/app';
/// API 주소에서 받기 화면 주소를 만든다 — `https://portal.arasystem.it.kr/api` → `https://portal.arasystem.it.kr/app`.
///
/// 출처(스킴 · 호스트 · 포트)만 남긴다: API 경로(`/api`) · 쿼리 · 조각 · 사용자 정보는 버리고, 스킴의 기본 포트는 적지 않는다.
/// http · https 주소가 아니거나 호스트가 없으면 null — 화면은 주소 없이 알린다
Uri? appDownloadPageUrlOf(String apiBaseUrl) {
final Uri? api = Uri.tryParse(apiBaseUrl.trim());
if (api == null) return null;
if (api.scheme != 'http' && api.scheme != 'https') return null;
if (api.host.isEmpty) return null;
return Uri(
scheme: api.scheme,
host: api.host,
port: api.hasPort ? api.port : null,
path: kAppDownloadPagePath,
);
}
/// 알림에 보이는 주소 — 스킴 없이(`portal.arasystem.it.kr/app` · `10.0.2.2:5173/app`).
/// 직원이 휴대폰 브라우저의 주소 칸에 그대로 넣는다
String appDownloadPageAddressOf(Uri url) => '${url.authority}${url.path}';
flutter/lib/core/app_download/app_download_texts.dart
+16
View File
@@ -0,0 +1,16 @@
/// 휴대폰 앱 받기 화면을 여는 [새 버전 받기]의 글 — 업데이트 화면(`features/app_update`)과 설정 › 앱 정보(`features/settings`)가 함께 쓴다.
///
/// 앱 보드 `App1Push` ⑩ · ④ 앱 정보 절(2026-11-08 확정 — 캔버스 v68)의 글 그대로다(디자인 README 「화면 문구 — 사용자에게 말하듯」).
abstract final class AppDownloadTexts {
/// 업데이트 화면의 단추 · 설정 › 앱 정보의 줄
static const String getNewVersion = '새 버전 받기';
/// 브라우저를 열지 못했을 때(알림) — [address] 는 받기 화면 주소를 스킴 없이(`portal.arasystem.it.kr/app`).
/// 직원이 휴대폰 브라우저에 직접 넣는다
static String openFailed(String address) =>
'브라우저를 열지 못했습니다. 휴대폰의 브라우저에서 $address에 들어가 새 버전을 받아 주세요.';
/// 받기 화면 주소를 만들지 못했을 때(앱의 API 주소가 http · https 주소가 아니다 — 보드에 없는 경우.
/// 그런 판은 서버에도 닿지 못해 업데이트 화면 · 설정 탭에 오지 않는다)
static const String openFailedNoAddress = '브라우저를 열지 못했습니다. 관리자에게 문의해 주세요.';
}
flutter/lib/core/constants/app_constants.dart
+1 -1
View File
@@ -1,7 +1,7 @@
/// 앱 전체에서 쓰는 이름 · 식별 값.
///
/// 식별자(Android applicationId · iOS bundle id `kr.it.arasystem.app`)는 플랫폼 설정 파일에 있다 —
/// 스토어에 올린 뒤에는 바꿀 수 없다.
/// 직원 휴대폰에 설치한 뒤에는 바꿀 수 없다(식별자가 다르면 다른 앱이라 새 판이 그 위에 설치되지 않는다).
library;
/// 홈 화면 · 작업 전환 화면에 보이는 앱 이름
flutter/lib/core/constants/app_info_provider.dart
-6
View File
@@ -5,9 +5,3 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
final Provider<String?> appVersionProvider = Provider<String?>(
(Ref ref) => null,
);
/// 앱 식별자(패키지 이름 — Android applicationId `kr.it.arasystem.app`). main 이 기기 정보를 읽어 덮어쓴다.
/// 업데이트 화면의 [Play 스토어 열기]가 쓴다 — 읽지 못했으면 null(단추를 누르면 열지 못했다고 알린다)
final Provider<String?> appPackageNameProvider = Provider<String?>(
(Ref ref) => null,
);
flutter/lib/features/app_update/data/app_store_launcher.dart
-52
View File
@@ -1,52 +0,0 @@
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:url_launcher/url_launcher.dart';
/// 다른 앱으로 주소를 넘기는 함수 — 기본은 url_launcher 의 [launchUrl]. 시험은 가짜를 넣는다
typedef StoreLaunch = Future<bool> Function(Uri url, LaunchMode mode);
Future<bool> _launchExternal(Uri url, LaunchMode mode) =>
launchUrl(url, mode: mode);
/// Play 스토어의 이 앱 쪽 주소(앱이 없을 때 여는 웹 주소)
const String kPlayStoreWebDetails =
'https://play.google.com/store/apps/details';
/// [Play 스토어 열기] — 이 앱의 Play 스토어 쪽을 연다(업데이트 화면).
///
/// 먼저 Play 스토어 앱(`market://details?id=…` — 브라우저가 아닌 앱만), 열리지 않으면 웹 주소를 바깥 앱(브라우저)으로.
/// 패키지 이름은 앱 정보에서 읽은 값이다(하드코딩하지 않는다). `canLaunchUrl` 은 쓰지 않는다(debug 판이 주소를 로그에 남긴다 —
/// 인증 앱 열기와 같은 규칙). 못 열면 플러그인 예외를 버리고 거짓 — 화면이 알린다
class AppStoreLauncher {
const AppStoreLauncher({StoreLaunch launch = _launchExternal})
: _launch = launch;
final StoreLaunch _launch;
/// 열었으면 참
Future<bool> open(String packageName) async {
final Uri market = Uri(
scheme: 'market',
host: 'details',
queryParameters: <String, String>{'id': packageName},
);
if (await _tryLaunch(market, LaunchMode.externalNonBrowserApplication)) {
return true;
}
final Uri web = Uri.parse(
kPlayStoreWebDetails,
).replace(queryParameters: <String, String>{'id': packageName});
return _tryLaunch(web, LaunchMode.externalApplication);
}
Future<bool> _tryLaunch(Uri url, LaunchMode mode) async {
try {
return await _launch(url, mode);
} on Object {
return false;
}
}
}
/// [Play 스토어 열기] — 시험은 가짜로 덮어쓴다
final Provider<AppStoreLauncher> appStoreLauncherProvider =
Provider<AppStoreLauncher>((Ref ref) => const AppStoreLauncher());
flutter/lib/features/app_update/presentation/app_update_texts.dart
+6 -10
View File
@@ -1,22 +1,18 @@
/// 업데이트 화면의 글 — 앱 보드 `App1Push` ⑩(2026-11-07 확정)의 글 그대로다. 제목은 `core/constants/screen_titles.dart` 의 `ScreenTitles.update`.
/// 업데이트 화면의 글 — 앱 보드 `App1Push` ⑩(2026-11-08 사내 직접 배포로 고쳐 확정 — 캔버스 v68)의 글 그대로다.
/// 제목은 `core/constants/screen_titles.dart` 의 `ScreenTitles.update`, [새 버전 받기]와 브라우저를 열지 못했을 때의 알림은
/// 설정 › 앱 정보와 함께 쓰므로 `core/app_download/app_download_texts.dart` 에 있다.
///
/// 화면 글은 디자인 README 「화면 문구 — 사용자에게 말하듯」 말투를 따른다.
abstract final class AppUpdateTexts {
static const String message =
'지금 쓰는 버전으로는 로그인하거나 메일을 볼 수 없습니다. Play 스토어에서 ARA SYSTEM을 업데이트한 뒤 다시 열어 주세요.';
static const String openStore = 'Play 스토어 열기';
'지금 쓰는 버전으로는 로그인하거나 메일을 볼 수 없습니다. 새 버전을 받아 설치한 뒤 다시 열어 주세요.';
/// 지금 쓰는 판 — "지금 쓰는 버전 1.0.0"
static String currentVersion(String version) => '지금 쓰는 버전 $version';
/// 문의 줄 — 연락처(`GET /api/support-contact`)가 있으면 물음 다음 줄에 연락처
static const String supportQuestion = 'Play 스토어에 업데이트가 보이지 않나요?';
static const String supportQuestion = '새 버전을 받거나 설치하기 어려우신가요?';
/// 연락처를 정하지 않았거나 받지 못했을 때(보드에 없는 경우 — 로그인 화면의 문의 줄과 같은 꼴)
static const String supportFallback =
'Play 스토어에 업데이트가 보이지 않나요? 관리자에게 문의해 주세요.';
/// Play 스토어를 열지 못했을 때(알림)
static const String openStoreFailed =
'Play 스토어를 열지 못했습니다. Play 스토어 앱을 직접 열어 ARA SYSTEM을 찾아 업데이트해 주세요.';
static const String supportFallback = '새 버전을 받거나 설치하기 어려우신가요? 관리자에게 문의해 주세요.';
}
flutter/lib/features/app_update/presentation/pages/app_update_page.dart
+10 -18
View File
@@ -1,11 +1,12 @@
import 'dart:async';
import 'package:arasystem_app/core/app_download/app_download_launcher.dart';
import 'package:arasystem_app/core/app_download/app_download_texts.dart';
import 'package:arasystem_app/core/constants/app_info_provider.dart';
import 'package:arasystem_app/core/constants/screen_titles.dart';
import 'package:arasystem_app/core/theme/app_spacing.dart';
import 'package:arasystem_app/core/theme/app_theme.dart';
import 'package:arasystem_app/core/theme/app_typography.dart';
import 'package:arasystem_app/features/app_update/data/app_store_launcher.dart';
import 'package:arasystem_app/features/app_update/presentation/app_update_texts.dart';
import 'package:arasystem_app/features/auth/presentation/providers/login_providers.dart';
import 'package:arasystem_app/features/auth/presentation/widgets/login_frame.dart';
@@ -17,9 +18,10 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
/// 업데이트 화면 — 앱 보드 `App1Push` ⑩. 이 앱의 판이 서버의 최소 판보다 낮으면 라우터가 어느 화면에서든 이리로 옮긴다
/// (로그인 전 화면도 — 옛 앱이 로그인 API 를 잘못 부르지 않게. `core/router/session_redirect.dart`).
///
/// - 로그인 첫 단계처럼 큰 브랜드 띠(로고만) 아래에 제목 · 글 · [Play 스토어 열기] · 지금 쓰는 판 · 문의 줄.
/// - [Play 스토어 열기]: Play 스토어 앱 → 안 되면 웹 주소. 열지 못하면 알린다.
/// - 뒤로 가기는 앱을 닫는다(이 화면으로는 `go` 로만 오니 쌓인 화면이 없다). 업데이트하면 Play 가 앱을 끝내고,
/// - 로그인 첫 단계처럼 큰 브랜드 띠(로고만) 아래에 제목 · 글 · [새 버전 받기] · 지금 쓰는 판 · 문의 줄.
/// - [새 버전 받기]: 포털의 휴대폰 앱 받기 화면(`<포털 출처>/app`)을 바깥 브라우저로 연다 — 앱은 스토어에 올리지 않고
/// 사내에서 직접 나눠 준다(2026-11-08). 열지 못하면 그 주소를 담아 알린다(설정 › 앱 정보와 같은 런처 · 알림 — `core/app_download/`).
/// - 뒤로 가기는 앱을 닫는다(이 화면으로는 `go` 로만 오니 쌓인 화면이 없다). 새 판을 설치하면 안드로이드가 이 앱을 끝내고,
/// 서버가 최소 판을 내리면 다음 확인에서 세션이 고른 화면으로 돌아간다.
class AppUpdatePage extends ConsumerStatefulWidget {
const AppUpdatePage({super.key});
@@ -35,18 +37,8 @@ class _AppUpdatePageState extends ConsumerState<AppUpdatePage> {
unawaited(ref.read(supportContactProvider.notifier).ensureLoaded());
}
Future<void> _openStore() async {
final ScaffoldMessengerState messenger = ScaffoldMessenger.of(context);
final String? packageName = ref.read(appPackageNameProvider);
final bool opened =
packageName != null &&
await ref.read(appStoreLauncherProvider).open(packageName);
if (opened) return;
messenger
..hideCurrentSnackBar()
..showSnackBar(
const SnackBar(content: KeepAllText(AppUpdateTexts.openStoreFailed)),
);
void _openDownloadPage() {
unawaited(openAppDownloadPage(ref, ScaffoldMessenger.of(context)));
}
@override
@@ -79,12 +71,12 @@ class _AppUpdatePageState extends ConsumerState<AppUpdatePage> {
],
),
FilledButton(
onPressed: () => unawaited(_openStore()),
onPressed: _openDownloadPage,
child: const Row(
mainAxisSize: MainAxisSize.min,
spacing: AppSpacing.s8,
children: <Widget>[
Text(AppUpdateTexts.openStore),
Text(AppDownloadTexts.getNewVersion),
Icon(Icons.open_in_new, size: AppSize.iconSmall),
],
),
flutter/lib/features/settings/presentation/pages/settings_page.dart
+34 -9
View File
@@ -1,5 +1,7 @@
import 'dart:async';
import 'package:arasystem_app/core/app_download/app_download_launcher.dart';
import 'package:arasystem_app/core/app_download/app_download_texts.dart';
import 'package:arasystem_app/core/constants/app_info_provider.dart';
import 'package:arasystem_app/core/modules/module_routes.dart';
import 'package:arasystem_app/core/theme/app_spacing.dart';
@@ -18,11 +20,12 @@ import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';
/// 설정 탭 — 앱 보드 `App1Shell`(설정 탭 · 로그아웃 확인 창)과 `App1Push` ④(새 메일 알림 줄).
/// 설정 탭 — 앱 보드 `App1Shell`(설정 탭 · 로그아웃 확인 창)과 `App1Push` ④(새 메일 알림 줄 · 앱 정보 절).
/// 글자는 테마 크기로 맞췄다(보드 15.5 → 16 · 14 → 15 · 13 → 13 — 앱 디자인 README 의 크기 정리와 같다).
///
/// 한 화면에 절을 모두 둔다: 내 정보(이름 · 주소) · 알림(새 메일 알림) · 다른 모듈이 내놓은 절 · 앱 정보(앱 버전 · 오픈소스 라이선스) ·
/// 문의(`GET /api/support-contact` — 로그인 화면과 같은 저장소, 화면을 열 때 받아 둔다) · [로그아웃].
/// 한 화면에 절을 모두 둔다: 내 정보(이름 · 주소) · 알림(새 메일 알림) · 다른 모듈이 내놓은 절 ·
/// 앱 정보(앱 버전 · [새 버전 받기] · 오픈소스 라이선스) · 문의(`GET /api/support-contact` — 로그인 화면과 같은 저장소, 화면을 열 때 받아 둔다) · [로그아웃].
/// [새 버전 받기]는 업데이트 화면의 단추처럼 포털의 휴대폰 앱 받기 화면을 바깥 브라우저로 연다(같은 런처 · 같은 실패 알림 — `core/app_download/`).
/// [로그아웃]은 확인 창부터 연다(처음 초점은 [취소] — 로그아웃하면 이 휴대폰의 새 메일 알림도 멈춘다고 알린다).
/// 비밀번호 · 2단계 인증 같은 계정 설정은 웹에서 한다.
class SettingsPage extends ConsumerStatefulWidget {
@@ -65,6 +68,10 @@ class _SettingsPageState extends ConsumerState<SettingsPage> {
await ref.read(sessionProvider.notifier).signOut();
}
void _openDownloadPage() {
unawaited(openAppDownloadPage(ref, ScaffoldMessenger.of(context)));
}
@override
Widget build(BuildContext context) {
final ThemeData theme = Theme.of(context);
@@ -118,6 +125,11 @@ class _SettingsPageState extends ConsumerState<SettingsPage> {
crossAxisAlignment: CrossAxisAlignment.stretch,
children: <Widget>[
_VersionRow(version: version),
_LinkRow(
label: AppDownloadTexts.getNewVersion,
opensOutside: true,
onTap: _openDownloadPage,
),
_LinkRow(
label: SettingsTexts.licenses,
onTap: () =>
@@ -321,13 +333,21 @@ class _VersionRow extends StatelessWidget {
}
}
/// 누르면 다른 화면으로 가는 한 줄 — 이름 · 오른쪽 화살표
/// 누르는 한 줄 — 이름 · 오른쪽 끝 아이콘. 앱 안의 다른 화면으로 가면 화살표, 바깥(브라우저)으로 열면 바깥으로 여는 아이콘
/// (보드: 화살표 20 · 바깥 아이콘 18 을 20 칸 가운데에 — 두 아이콘의 가운데가 맞는다)
class _LinkRow extends StatelessWidget {
const _LinkRow({required this.label, required this.onTap});
const _LinkRow({
required this.label,
required this.onTap,
this.opensOutside = false,
});
final String label;
final VoidCallback? onTap;
/// 바깥 앱(브라우저)으로 연다 — 끝 아이콘이 바깥으로 여는 아이콘
final bool opensOutside;
@override
Widget build(BuildContext context) {
final ThemeData theme = Theme.of(context);
@@ -352,10 +372,15 @@ class _LinkRow extends StatelessWidget {
children: <Widget>[
Expanded(child: Text(label, style: theme.textTheme.bodyLarge)),
ExcludeSemantics(
child: Icon(
Icons.chevron_right,
size: AppSize.iconMedium,
color: extra.textMuted,
child: SizedBox.square(
dimension: AppSize.iconMedium,
child: Icon(
opensOutside ? Icons.open_in_new : Icons.chevron_right,
size: opensOutside
? AppSize.iconSmall
: AppSize.iconMedium,
color: extra.textMuted,
),
),
),
],
flutter/lib/features/settings/presentation/settings_texts.dart
+1
View File
@@ -1,5 +1,6 @@
/// 설정 모듈의 화면 글 — 앱 보드 `App1Shell`(설정 탭 · 로그아웃 확인 창)의 글 그대로다.
/// 새 메일 알림 줄의 글은 받은편지함 권하기 줄과 함께 쓰므로 `core/push/push_texts.dart` 에 있다(보드 `App1Push`).
/// 앱 정보의 [새 버전 받기] 줄과 그 실패 알림은 업데이트 화면과 함께 쓰므로 `core/app_download/app_download_texts.dart` 에 있다(보드 `App1Push` ④).
///
/// 화면 글은 디자인 README 「화면 문구 — 사용자에게 말하듯」 말투를 따른다.
abstract final class SettingsTexts {
flutter/lib/main.dart
+2 -8
View File
@@ -41,13 +41,8 @@ Future<void> main() async {
firstRun: PrefsFirstRunMarker(),
);
await tokenStore.prepare();
final ({
String? appVersion,
String? packageName,
String userAgent,
int? androidSdkInt,
})
device = await loadAppDeviceInfo();
final ({String? appVersion, String userAgent, int? androidSdkInt}) device =
await loadAppDeviceInfo();
// 새 메일 알림(FCM) — Firebase 를 띄우고 플러그인의 소식 줄(FID · 받은 알림 · 누른 알림)을 지금 듣는다.
// 띄우지 못하면(google-services.json 없이 빌드 · 5초 넘음) 알림 없이 돈다 — 설정 줄은 "이 휴대폰에서는 받을 수 없음"
@@ -70,7 +65,6 @@ Future<void> main() async {
tokenStoreProvider.overrideWithValue(tokenStore),
userAgentProvider.overrideWithValue(device.userAgent),
appVersionProvider.overrideWithValue(device.appVersion),
appPackageNameProvider.overrideWithValue(device.packageName),
downloadedFileStoreProvider.overrideWithValue(downloadedFiles),
pickedFileStoreProvider.overrideWithValue(pickedFiles),
pushMessagingProvider.overrideWithValue(pushMessaging),
flutter/test/core/app_download/app_download_launcher_test.dart
+101
View File
@@ -0,0 +1,101 @@
import 'package:arasystem_app/core/api/api_config.dart';
import 'package:arasystem_app/core/api/dio_provider.dart';
import 'package:arasystem_app/core/app_download/app_download_launcher.dart';
import 'package:arasystem_app/core/app_download/app_download_texts.dart';
import 'package:arasystem_app/core/utils/provider_retry.dart';
import 'package:flutter/services.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_riverpod/misc.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:url_launcher/url_launcher.dart';
/// [새 버전 받기]의 런처 — 업데이트 화면 · 설정 › 앱 정보가 함께 쓴다(화면은 각 화면 시험이 본다)
void main() {
/// 다른 앱으로 넘긴 주소 · 방식
final List<({Uri url, LaunchMode mode})> launched =
<({Uri url, LaunchMode mode})>[];
setUp(launched.clear);
AppDownloadLauncher launcherOf(
String apiBaseUrl, {
required Future<bool> Function() answer,
}) => AppDownloadLauncher(
apiBaseUrl: apiBaseUrl,
launch: (Uri url, LaunchMode mode) {
launched.add((url: url, mode: mode));
return answer();
},
);
test('받기 화면을 바깥 앱(브라우저)으로 한 번 연다 — 열었으면 참', () async {
final AppDownloadLauncher launcher = launcherOf(
'https://portal.arasystem.it.kr/api',
answer: () async => true,
);
expect(await launcher.open(), isTrue);
expect(launched, hasLength(1));
expect(
launched.single.url,
Uri.parse('https://portal.arasystem.it.kr/app'),
);
expect(launched.single.mode, LaunchMode.externalApplication);
});
test('열지 못하면 거짓 — 알림 글은 받기 화면 주소를 스킴 없이 담는다', () async {
final AppDownloadLauncher launcher = launcherOf(
'https://portal.arasystem.it.kr/api',
answer: () async => false,
);
expect(await launcher.open(), isFalse);
expect(
launcher.failureMessage,
'브라우저를 열지 못했습니다. 휴대폰의 브라우저에서 portal.arasystem.it.kr/app에 들어가 새 버전을 받아 주세요.',
);
});
test('여는 쪽이 던지면(받을 앱 없음) 삼키고 거짓 — 예외의 주소를 밖으로 내보내지 않는다', () async {
final AppDownloadLauncher launcher = launcherOf(
'https://portal.arasystem.it.kr/api',
answer: () async => throw PlatformException(
code: 'ACTIVITY_NOT_FOUND',
message:
'No Activity found to handle https://portal.arasystem.it.kr/app',
),
);
expect(await launcher.open(), isFalse);
expect(launched, hasLength(1));
});
test('API 주소로 받기 화면 주소를 만들지 못하면 열지 않고 거짓 — 주소 없는 알림 글', () async {
final AppDownloadLauncher launcher = launcherOf(
'portal.arasystem.it.kr/api',
answer: () async => true,
);
expect(launcher.pageUrl, isNull);
expect(await launcher.open(), isFalse);
expect(launched, isEmpty);
expect(launcher.failureMessage, AppDownloadTexts.openFailedNoAddress);
});
test('프로바이더는 앱의 API 주소(apiConfigProvider)로 받기 화면 주소를 만든다', () {
final ProviderContainer container = ProviderContainer(
retry: noAutomaticRetry,
overrides: <Override>[
apiConfigProvider.overrideWithValue(
const ApiConfig(baseUrl: 'http://10.0.2.2:5173/api'),
),
],
);
addTearDown(container.dispose);
expect(
container.read(appDownloadLauncherProvider).pageUrl,
Uri.parse('http://10.0.2.2:5173/app'),
);
});
}
flutter/test/core/app_download/app_download_link_test.dart
+119
View File
@@ -0,0 +1,119 @@
import 'package:arasystem_app/core/app_download/app_download_link.dart';
import 'package:flutter_test/flutter_test.dart';
/// 포털의 휴대폰 앱 받기 화면 주소 — 앱의 API 주소(같은 주소 배포 — 포털 출처의 `/api`)에서 `/api` 를 뗀 출처 + `/app`
void main() {
group('받기 화면 주소', () {
test('운영 — https://portal.arasystem.it.kr/api 의 출처에 /app', () {
expect(
appDownloadPageUrlOf('https://portal.arasystem.it.kr/api'),
Uri.parse('https://portal.arasystem.it.kr/app'),
);
expect(
appDownloadPageUrlOf('https://portal.arasystem.it.kr/api/'),
Uri.parse('https://portal.arasystem.it.kr/app'),
reason: '끝의 / 가 붙어도 같다',
);
expect(
appDownloadPageUrlOf(' https://portal.arasystem.it.kr/api '),
Uri.parse('https://portal.arasystem.it.kr/app'),
reason: '앞뒤 공백은 뗀다',
);
});
test('개발 — 포트는 그대로 둔다(에뮬레이터 · vite 개발 서버)', () {
expect(
appDownloadPageUrlOf('http://10.0.2.2:3000/api'),
Uri.parse('http://10.0.2.2:3000/app'),
);
expect(
appDownloadPageUrlOf('http://10.0.2.2:5173/api'),
Uri.parse('http://10.0.2.2:5173/app'),
);
expect(
appDownloadPageUrlOf('http://localhost:5173/api'),
Uri.parse('http://localhost:5173/app'),
);
expect(
appDownloadPageUrlOf('http://[::1]:3000/api'),
Uri.parse('http://[::1]:3000/app'),
reason: 'IPv6 주소는 대괄호째',
);
});
test('스킴의 기본 포트는 적지 않고, 그 밖의 포트는 남긴다', () {
expect(
appDownloadPageUrlOf('https://portal.arasystem.it.kr:443/api'),
Uri.parse('https://portal.arasystem.it.kr/app'),
);
expect(
appDownloadPageUrlOf('http://portal.arasystem.it.kr:80/api'),
Uri.parse('http://portal.arasystem.it.kr/app'),
);
expect(
appDownloadPageUrlOf('https://portal.arasystem.it.kr:8443/api'),
Uri.parse('https://portal.arasystem.it.kr:8443/app'),
);
});
test('출처만 남긴다 — 쿼리 · 조각 · 사용자 정보는 버리고 대문자는 소문자로', () {
final Uri? url = appDownloadPageUrlOf(
'HTTPS://user:pw@Portal.Arasystem.IT.KR/api?x=1#y',
);
expect(url, Uri.parse('https://portal.arasystem.it.kr/app'));
expect(url!.userInfo, isEmpty);
expect(url.hasQuery, isFalse);
expect(url.hasFragment, isFalse);
expect(url.toString(), 'https://portal.arasystem.it.kr/app');
});
test('http · https 주소가 아니거나 호스트가 없으면 null', () {
for (final String input in <String>[
'',
' ',
'portal.arasystem.it.kr/api',
'/api',
'not a url',
'ftp://portal.arasystem.it.kr/api',
'file:///api',
'market://details?id=kr.it.arasystem.app',
'https:///api',
'http://[::1',
]) {
expect(appDownloadPageUrlOf(input), isNull, reason: input);
}
});
test('경로는 웹의 받기 화면 경로와 같다', () {
expect(kAppDownloadPagePath, '/app');
});
});
group('알림에 보이는 주소 — 스킴 없이', () {
test('호스트 · 포트 · 경로', () {
expect(
appDownloadPageAddressOf(
Uri.parse('https://portal.arasystem.it.kr/app'),
),
'portal.arasystem.it.kr/app',
);
expect(
appDownloadPageAddressOf(Uri.parse('http://10.0.2.2:5173/app')),
'10.0.2.2:5173/app',
);
expect(
appDownloadPageAddressOf(Uri.parse('http://[::1]:3000/app')),
'[::1]:3000/app',
);
});
test('만든 주소를 그대로 보인다', () {
expect(
appDownloadPageAddressOf(
appDownloadPageUrlOf('https://portal.arasystem.it.kr/api')!,
),
'portal.arasystem.it.kr/app',
);
});
});
}
flutter/test/features/app_update/app_update_page_test.dart
+74 -46
View File
@@ -1,10 +1,12 @@
import 'package:arasystem_app/core/api/api_paths.dart';
import 'package:arasystem_app/core/app_download/app_download_launcher.dart';
import 'package:arasystem_app/core/app_download/app_download_texts.dart';
import 'package:arasystem_app/core/constants/app_info_provider.dart';
import 'package:arasystem_app/core/constants/screen_titles.dart';
import 'package:arasystem_app/features/app_update/data/app_store_launcher.dart';
import 'package:arasystem_app/features/app_update/presentation/app_update_texts.dart';
import 'package:arasystem_app/features/app_update/presentation/pages/app_update_page.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_riverpod/misc.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:url_launcher/url_launcher.dart';
@@ -12,19 +14,19 @@ import 'package:url_launcher/url_launcher.dart';
import '../../support/fakes.dart';
import '../../support/login_fakes.dart';
/// 시험 앱의 패키지 이름
const String _package = 'kr.it.arasystem.app';
/// 운영의 앱 API 주소 — 받기 화면은 그 출처의 `/app`
const String _apiBaseUrl = 'https://portal.arasystem.it.kr/api';
/// 업데이트 화면 — 앱 보드 `App1Push` ⑩. 이 앱(1.0.0)이 서버의 최소 판(2.0.0)보다 낮다
/// 업데이트 화면 — 앱 보드 `App1Push` ⑩(2026-11-08 사내 직접 배포). 이 앱(1.0.0)이 서버의 최소 판(2.0.0)보다 낮다
void main() {
late LoginHarness h;
/// 다른 앱으로 넘긴 주소 · 방식 — [opens] 가 답한다(주소마다)
/// 다른 앱으로 넘긴 주소 · 방식 — [opens] 가 답한다
final List<({Uri url, LaunchMode mode})> launched =
<({Uri url, LaunchMode mode})>[];
late bool Function(Uri url) opens;
late Future<bool> Function(Uri url) opens;
Future<bool> launch(Uri url, LaunchMode mode) async {
Future<bool> launch(Uri url, LaunchMode mode) {
launched.add((url: url, mode: mode));
return opens(url);
}
@@ -32,7 +34,7 @@ void main() {
setUp(() {
h = LoginHarness();
launched.clear();
opens = (Uri _) => true;
opens = (Uri _) async => true;
h.server.on(
'GET',
ApiPaths.appConfig,
@@ -43,25 +45,24 @@ void main() {
);
});
Future<void> pump(WidgetTester tester, {String? packageName = _package}) =>
Future<void> pump(WidgetTester tester, {String apiBaseUrl = _apiBaseUrl}) =>
h.pump(
tester,
overrides: <Override>[
appVersionProvider.overrideWithValue('1.0.0'),
appPackageNameProvider.overrideWithValue(packageName),
appStoreLauncherProvider.overrideWithValue(
AppStoreLauncher(launch: launch),
appDownloadLauncherProvider.overrideWithValue(
AppDownloadLauncher(apiBaseUrl: apiBaseUrl, launch: launch),
),
],
);
Finder storeButton() =>
find.widgetWithText(FilledButton, AppUpdateTexts.openStore);
Finder downloadButton() =>
find.widgetWithText(FilledButton, AppDownloadTexts.getNewVersion);
Finder snack(String text) =>
find.descendant(of: find.byType(SnackBar), matching: findCopy(text));
testWidgets('제목 · 글 · [Play 스토어 열기] · 지금 쓰는 판 · 문의 줄(연락처)', (
testWidgets('제목 · 글 · [새 버전 받기] · 지금 쓰는 판 · 문의 줄(연락처)', (
WidgetTester tester,
) async {
h.supportContact('정보보안팀 02-1234-5678');
@@ -70,12 +71,21 @@ void main() {
expect(find.byType(AppUpdatePage), findsOneWidget);
expect(find.text(ScreenTitles.update), findsOneWidget);
expect(findCopy(AppUpdateTexts.message), findsOneWidget);
expect(storeButton(), findsOneWidget);
expect(downloadButton(), findsOneWidget);
expect(
find.descendant(
of: downloadButton(),
matching: find.byIcon(Icons.open_in_new),
),
findsOneWidget,
reason: '바깥(브라우저)으로 연다',
);
expect(find.text(AppUpdateTexts.currentVersion('1.0.0')), findsOneWidget);
expect(
findCopy('${AppUpdateTexts.supportQuestion}\n정보보안팀 02-1234-5678'),
findsOneWidget,
);
expect(launched, isEmpty, reason: '누르기 전에는 열지 않는다');
expect(h.notifier.shownCodes, isEmpty);
});
@@ -86,54 +96,72 @@ void main() {
expect(findCopy(AppUpdateTexts.supportFallback), findsOneWidget);
});
testWidgets('[Play 스토어 열기] — Play 스토어 앱부터, 열리지 않으면 웹 주소를 바깥 앱으로', (
testWidgets('[새 버전 받기] — 포털의 휴대폰 앱 받기 화면을 바깥 브라우저로 한 번 연다', (
WidgetTester tester,
) async {
opens = (Uri url) => url.scheme != 'market';
await pump(tester);
await tester.tap(storeButton());
await tester.pumpAndSettle();
expect(launched, hasLength(2));
expect(launched.first.url.toString(), 'market://details?id=$_package');
expect(launched.first.mode, LaunchMode.externalNonBrowserApplication);
expect(
launched.last.url.toString(),
'https://play.google.com/store/apps/details?id=$_package',
);
expect(launched.last.mode, LaunchMode.externalApplication);
expect(snack(AppUpdateTexts.openStoreFailed), findsNothing);
});
testWidgets('Play 스토어 앱이 열리면 웹 주소는 열지 않는다', (WidgetTester tester) async {
await pump(tester);
await tester.tap(storeButton());
await tester.tap(downloadButton());
await tester.pumpAndSettle();
expect(launched, hasLength(1));
expect(launched.single.url.scheme, 'market');
expect(
launched.single.url,
Uri.parse('https://portal.arasystem.it.kr/app'),
);
expect(launched.single.mode, LaunchMode.externalApplication);
expect(find.byType(SnackBar), findsNothing);
expect(find.byType(AppUpdatePage), findsOneWidget, reason: '화면은 그대로');
});
testWidgets('둘 다 열지 못하면 직접 찾아 업데이트해 달라고 알린다', (WidgetTester tester) async {
opens = (Uri _) => false;
testWidgets('브라우저를 열지 못하면 받기 화면 주소를 스킴 없이 담아 알린다', (
WidgetTester tester,
) async {
opens = (Uri _) async => false;
await pump(tester);
await tester.tap(storeButton());
await tester.tap(downloadButton());
await tester.pumpAndSettle();
expect(launched, hasLength(2));
expect(snack(AppUpdateTexts.openStoreFailed), findsOneWidget);
expect(launched, hasLength(1));
expect(
snack(AppDownloadTexts.openFailed('portal.arasystem.it.kr/app')),
findsOneWidget,
);
expect(
AppDownloadTexts.openFailed('portal.arasystem.it.kr/app'),
'브라우저를 열지 못했습니다. 휴대폰의 브라우저에서 portal.arasystem.it.kr/app에 들어가 새 버전을 받아 주세요.',
reason: '보드 ⑩ 의 알림 글 그대로',
);
});
testWidgets('패키지 이름을 읽지 못했으면 열지 않고 알린다', (WidgetTester tester) async {
await pump(tester, packageName: null);
testWidgets('여는 쪽이 던져도(받을 앱 없음) 삼키고 같은 알림 — 개발 주소는 포트까지 보인다', (
WidgetTester tester,
) async {
opens = (Uri url) async =>
throw PlatformException(code: 'ACTIVITY_NOT_FOUND', message: '$url');
await pump(tester, apiBaseUrl: 'http://10.0.2.2:5173/api');
await tester.tap(storeButton());
await tester.tap(downloadButton());
await tester.pumpAndSettle();
expect(launched.single.url, Uri.parse('http://10.0.2.2:5173/app'));
expect(
snack(AppDownloadTexts.openFailed('10.0.2.2:5173/app')),
findsOneWidget,
);
expect(tester.takeException(), isNull);
});
testWidgets('API 주소로 받기 화면 주소를 만들지 못하면 열지 않고 관리자에게 문의해 달라고 알린다', (
WidgetTester tester,
) async {
await pump(tester, apiBaseUrl: 'portal.arasystem.it.kr/api');
await tester.tap(downloadButton());
await tester.pumpAndSettle();
expect(launched, isEmpty);
expect(snack(AppUpdateTexts.openStoreFailed), findsOneWidget);
expect(snack(AppDownloadTexts.openFailedNoAddress), findsOneWidget);
});
}
flutter/test/features/settings/settings_page_test.dart
+112
View File
@@ -1,6 +1,8 @@
import 'dart:async';
import 'package:arasystem_app/core/api/api_paths.dart';
import 'package:arasystem_app/core/app_download/app_download_launcher.dart';
import 'package:arasystem_app/core/app_download/app_download_texts.dart';
import 'package:arasystem_app/core/push/notification_system.dart';
import 'package:arasystem_app/core/push/push_messaging.dart';
import 'package:arasystem_app/core/push/push_preferences.dart';
@@ -9,6 +11,7 @@ import 'package:arasystem_app/features/auth/presentation/pages/login_page.dart';
import 'package:arasystem_app/features/settings/presentation/settings_texts.dart';
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:url_launcher/url_launcher.dart';
import '../../support/fakes.dart';
import '../../support/login_fakes.dart';
@@ -101,6 +104,115 @@ void main() {
});
});
group('설정 › 앱 정보 › [새 버전 받기] — 앱 보드 App1Push ④', () {
/// 다른 앱으로 넘긴 주소 · 방식 — [opens] 가 답한다
final List<({Uri url, LaunchMode mode})> launched =
<({Uri url, LaunchMode mode})>[];
late bool opens;
setUp(() {
launched.clear();
opens = true;
h.app.overrides.add(
appDownloadLauncherProvider.overrideWithValue(
AppDownloadLauncher(
apiBaseUrl: 'https://portal.arasystem.it.kr/api',
launch: (Uri url, LaunchMode mode) async {
launched.add((url: url, mode: mode));
return opens;
},
),
),
);
});
Finder downloadRow() => find.ancestor(
of: find.text(AppDownloadTexts.getNewVersion),
matching: find.byType(InkWell),
);
Finder rowIcon(String label, IconData icon) => find.descendant(
of: find.ancestor(of: find.text(label), matching: find.byType(InkWell)),
matching: find.byIcon(icon),
);
Finder snack(String text) =>
find.descendant(of: find.byType(SnackBar), matching: findCopy(text));
testWidgets('줄 차례 — 앱 버전 · 새 버전 받기 · 오픈소스 라이선스, 끝 아이콘은 바깥으로 여는 아이콘', (
WidgetTester tester,
) async {
await h.pump(tester);
await h.openSettings(tester);
final double version = tester
.getTopLeft(find.text(SettingsTexts.appVersion))
.dy;
final double download = tester
.getTopLeft(find.text(AppDownloadTexts.getNewVersion))
.dy;
final double licenses = tester
.getTopLeft(find.text(SettingsTexts.licenses))
.dy;
expect(version, lessThan(download));
expect(download, lessThan(licenses));
expect(
rowIcon(AppDownloadTexts.getNewVersion, Icons.open_in_new),
findsOneWidget,
);
expect(
rowIcon(AppDownloadTexts.getNewVersion, Icons.chevron_right),
findsNothing,
);
expect(
rowIcon(SettingsTexts.licenses, Icons.chevron_right),
findsOneWidget,
);
expect(
tester.getSize(downloadRow()).height,
greaterThanOrEqualTo(52),
reason: '한 줄 칸 52 — 앱 버전 · 오픈소스 라이선스와 같다',
);
expect(launched, isEmpty);
});
testWidgets('누르면 업데이트 화면과 같은 받기 화면을 바깥 브라우저로 연다 — 설정에 머문다', (
WidgetTester tester,
) async {
await h.pump(tester);
await h.openSettings(tester);
await tapVisible(tester, find.text(AppDownloadTexts.getNewVersion));
expect(launched, hasLength(1));
expect(
launched.single.url,
Uri.parse('https://portal.arasystem.it.kr/app'),
);
expect(launched.single.mode, LaunchMode.externalApplication);
expect(h.app.location(), '/settings');
expect(find.byType(SnackBar), findsNothing);
expect(h.notifier.shownCodes, isEmpty);
});
testWidgets('브라우저를 열지 못하면 업데이트 화면과 같은 알림 — 받기 화면 주소를 담는다', (
WidgetTester tester,
) async {
opens = false;
await h.pump(tester);
await h.openSettings(tester);
await tapVisible(tester, find.text(AppDownloadTexts.getNewVersion));
expect(launched, hasLength(1));
expect(
snack(AppDownloadTexts.openFailed('portal.arasystem.it.kr/app')),
findsOneWidget,
);
expect(h.app.location(), '/settings');
});
});
group('[로그아웃] — 확인 창부터', () {
testWidgets('처음 초점은 [취소] — [취소]면 머물고 로그아웃하지 않는다', (
WidgetTester tester,