5 Commits

23 changed files with 1096 additions and 246 deletions
+2 -1
View File
@@ -1,3 +1,4 @@
{ {
"dart.flutterSdkPath": ".fvm/versions/stable" "dart.flutterSdkPath": ".fvm/versions/stable",
"cmake.sourceDirectory": "C:/Users/sindo/moonwell_launcher/windows"
} }
+14 -3
View File
@@ -6,9 +6,10 @@ change.
## Project Shape ## Project Shape
MoonWell Launcher is a Flutter desktop app for a private World of Warcraft: MoonWell Launcher is a Flutter desktop app for a private World of Warcraft
Wrath of the Lich King server. It logs players in, downloads and synchronizes 1.12.1 server running vMaNGOS. It logs players in, downloads and synchronizes
client files, displays launcher news, and starts `Wow.exe`. client files, displays launcher news, and starts the Rust MoonWell client
(`MoonWell.exe` on Windows or `MoonWell.app` on macOS).
Important areas: Important areas:
@@ -75,6 +76,10 @@ The optional Windows self-update feed is also compile-time configuration:
Production AppCast feeds must be public HTTPS URLs. Omit the setting to disable Production AppCast feeds must be public HTTPS URLs. Omit the setting to disable
self-update in local builds. self-update in local builds.
`MOONWELL_AUTH_ADDRESS` optionally pins the game's auth endpoint as `host[:port]`
(default port 3724). Otherwise it is read from `realmlist.wtf` in the selected
installation root. A realm's world port is not the auth port.
Do not commit private credentials, production secrets, temporary bearer tokens, Do not commit private credentials, production secrets, temporary bearer tokens,
or local-only API URLs. or local-only API URLs.
@@ -93,6 +98,12 @@ or local-only API URLs.
replace the destination file only after successful verification. replace the destination file only after successful verification.
- Local scans should ignore volatile client directories and launcher metadata: - Local scans should ignore volatile client directories and launcher metadata:
`Cache`, `Errors`, `Logs`, `Screenshots`, `WTF`, and `.moonwell_launcher`. `Cache`, `Errors`, `Logs`, `Screenshots`, `WTF`, and `.moonwell_launcher`.
- MoonWell player state lives in `benilla-config` outside the WoW data and, on
macOS, outside the application bundle. Exclude it from verification too.
- Request game tickets for build 5875. Pass their account and ticket as
`WOW_USER` and `WOW_PASS` in the child environment, never in arguments or
persistent storage. Starting MoonWell must not edit `WTF/Config.wtf` or clear
the install's `Cache`.
- Path normalization and traversal checks are safety-critical. Do not bypass - Path normalization and traversal checks are safety-critical. Do not bypass
`GameInstallationService.resolveClientPath` for manifest-relative paths. `GameInstallationService.resolveClientPath` for manifest-relative paths.
- `lib/service_container.config.dart` is generated by injectable. Do not - `lib/service_container.config.dart` is generated by injectable. Do not
+29 -3
View File
@@ -1,7 +1,7 @@
# MoonWell Launcher # MoonWell Launcher
MoonWell Launcher is the desktop launcher for MoonWell, a private World of MoonWell Launcher is the desktop launcher for MoonWell, a private World of
Warcraft: Wrath of the Lich King server focused on a player-friendly experience Warcraft 1.12.1 server on vMaNGOS, focused on a player-friendly experience
without excessive grind and with stronger social play. without excessive grind and with stronger social play.
The Windows executable requests administrator privileges on startup so it can The Windows executable requests administrator privileges on startup so it can
@@ -19,7 +19,9 @@ The launcher is responsible for:
- downloading and synchronizing client files - downloading and synchronizing client files
- displaying launcher news - displaying launcher news
- displaying the live status of the first configured realm - displaying the live status of the first configured realm
- launching the game client - requesting a single-use game ticket and launching the game client without
putting credentials in command-line arguments
- starting the Rust MoonWell client on Windows and macOS
## Stack ## Stack
@@ -59,6 +61,11 @@ Set the public AppCast feed URL to enable Windows launcher self-updates:
The updater is disabled when `MOONWELL_APPCAST_URL` is omitted. Production The updater is disabled when `MOONWELL_APPCAST_URL` is omitted. Production
feeds must use HTTPS. feeds must use HTTPS.
The game's auth endpoint is read from `realmlist.wtf` in the selected client
folder. For builds that pin an endpoint, set
`--dart-define=MOONWELL_AUTH_ADDRESS=login.example:3724` instead. This endpoint is
the vMaNGOS auth server, separate from the realm's world port and the Web API.
Example run command: Example run command:
```powershell ```powershell
@@ -140,7 +147,26 @@ The launcher sync flow is manifest-based:
6. remove stale files outside ignored directories 6. remove stale files outside ignored directories
7. download missing or changed files to temporary part files 7. download missing or changed files to temporary part files
8. verify size and SHA-256 before replacing client files 8. verify size and SHA-256 before replacing client files
9. launch `Wow.exe` from the selected client directory 9. request a short-lived game ticket for build 5875 and launch MoonWell from the
selected client directory with authorization in its child environment
The selected folder must contain `MoonWell.exe` on Windows, or `MoonWell.app`
on macOS, and your own 1.12.1 data in `Data/` or `WoW/Data/`. macOS launches the
bundle's `Contents/MacOS/launch` directly so the launcher keeps a handle to the
game process. `benilla-config/` stays beside the EXE or `.app`.
The ticket's account and temporary password become `WOW_USER` and `WOW_PASS`;
the launcher also sets `WOW_HOST`, `WOW_DATA`, and `BENILLA_HOME` for that child
only. Launching does not clear the WoW cache or modify `WTF/Config.wtf`.
The ticket is consumed by `realmd` after a successful proof; a new login attempt
requires a fresh ticket from the launcher.
In the local WSL deployment, Web API traffic uses the web service's published
port 8080, while game authorization and the world use ports 3724 and 8085.
The web application writes ticket SRP data to `realmd.launcher_ticket`; the
modified auth server consumes it. No additional web/core endpoint is required.
Distribute the MoonWell executable and the 1.12.1 data in the client manifest
before enabling automatic synchronization for that distribution.
See `docs/launcher_web_api_spec.md` for the API and sync contract. See `docs/launcher_web_api_spec.md` for the API and sync contract.
+6
View File
@@ -7,6 +7,12 @@
# The following line activates a set of recommended lints for Flutter apps, # The following line activates a set of recommended lints for Flutter apps,
# packages, and plugins designed to encourage good coding practices. # packages, and plugins designed to encourage good coding practices.
analyzer:
exclude:
- build/**
- windows/**
- macos/**
- linux/**
include: package:flutter_lints/flutter.yaml include: package:flutter_lints/flutter.yaml
linter: linter:
+4 -4
View File
@@ -5,10 +5,10 @@
<description>MoonWell Launcher updates</description> <description>MoonWell Launcher updates</description>
<language>ru</language> <language>ru</language>
<item> <item>
<title>MoonWell Launcher 1.0.2</title> <title>MoonWell Launcher 1.0.5</title>
<description>Исправлено отображение версии и добавлен запуск с правами администратора.</description> <description>Запуск Rust-клиента MoonWell 1.12.1, вход через игровой билет, обновления клиента и необходимые библиотеки Visual C++ в установщике.</description>
<pubDate>Tue, 28 Jul 2026 21:23:41 +04:00</pubDate> <pubDate>Sun, 04 Oct 2026 13:02:31 +04:00</pubDate>
<enclosure url="https://storage.yandexcloud.net/warcraft-client/moonwell_launcher_setup.exe" sparkle:version="1.0.2+4" sparkle:shortVersionString="1.0.2" sparkle:os="windows" sparkle:dsaSignature="MD0CHQDFH5GJKhykmXEZJTInFPrsoIkDc9tKroeR2XvJAhxrRjugtgetJlDiAhlyOtvgIYVRmAIb2sVqLelj" length="19994970" type="application/octet-stream" /> <enclosure url="https://storage.yandexcloud.net/warcraft-client/moonwell_launcher/releases/1.0.5/moonwell_launcher_setup.exe" sparkle:version="1.0.5+8" sparkle:shortVersionString="1.0.5" sparkle:os="windows" sparkle:dsaSignature="MDwCHHxkF+i05qKMxqUoWEFXZO5mtSy+0rX9/VvvcsUCHBb8ErwfgwRpS6pZtGwzfBvlze6tUJqkJ2aHrg4=" length="20587331" type="application/octet-stream" />
</item> </item>
</channel> </channel>
</rss> </rss>
+44 -9
View File
@@ -8,7 +8,7 @@ This document specifies the current launcher behavior for:
- installation directory selection - installation directory selection
- local file scan and hash calculation - local file scan and hash calculation
- manifest-based synchronization - manifest-based synchronization
- client launch from `Wow.exe` - launch and game authorization for the Rust MoonWell 1.12.1 client
The launcher no longer uses S3/MinIO directly. All server interaction goes The launcher no longer uses S3/MinIO directly. All server interaction goes
through the Web API. through the Web API.
@@ -18,6 +18,7 @@ through the Web API.
The launcher API base URL is provided via: The launcher API base URL is provided via:
- `MOONWELL_API_BASE_URL` - `MOONWELL_API_BASE_URL`
- optional `MOONWELL_AUTH_ADDRESS` for the game auth endpoint (`host[:port]`)
Current integration mode is compile-time: Current integration mode is compile-time:
@@ -35,6 +36,7 @@ The launcher uses these endpoints from `openapi.json`:
5. `GET /api/launcher/news` 5. `GET /api/launcher/news`
6. `GET /api/launcher/realms` 6. `GET /api/launcher/realms`
7. `GET /api/launcher/account` 7. `GET /api/launcher/account`
8. `POST /api/launcher/game-ticket`
Registration sequence: Registration sequence:
@@ -106,6 +108,20 @@ Account sequence:
3. The response `balance` field is intentionally ignored and never displayed. 3. The response `balance` field is intentionally ignored and never displayed.
4. Account metadata failures do not block patching or launching the game. 4. Account metadata failures do not block patching or launching the game.
Game authorization sequence:
1. Immediately before starting the game, the launcher calls
`POST /api/launcher/game-ticket` with bearer authentication and
`{ "client_build": 5875 }` in the JSON body.
2. The API returns `account`, a 16-character `A-Z0-9` single-use `ticket`, and
`expires_at`. The account is 3–16 uppercase `A-Z0-9` characters. The ticket
must remain valid for at least five more seconds, including at process start.
3. Issuing a ticket atomically revokes any previous unused game ticket for the
same account. Production lifetime must not exceed 60 seconds.
4. The launcher never persists or logs the ticket.
5. The auth server uses the ticket as the temporary SRP password and consumes
it atomically after a successful logon proof.
## Installation Directory Rules ## Installation Directory Rules
The user selects a single installation root directory. The user selects a single installation root directory.
@@ -128,6 +144,7 @@ The launcher excludes these top-level directories from verification:
- `Logs` - `Logs`
- `Screenshots` - `Screenshots`
- `WTF` - `WTF`
- `benilla-config`
Files under these directories: Files under these directories:
@@ -230,15 +247,32 @@ Pause is implemented as cooperative cancellation:
When the user presses `Play`: When the user presses `Play`:
1. launcher resolves `<install-root>/Wow.exe` 1. launcher requests a single-use game ticket for build 5875
2. launcher clears `<install-root>/Cache` 2. launcher resolves `<install-root>/MoonWell.exe` on Windows,
3. launcher starts `Wow.exe` with working directory set to installation root `<install-root>/MoonWell.app/Contents/MacOS/launch` on macOS, or
and retains a process handle `<install-root>/MoonWell` on Linux
4. while the process is alive, the launcher disables repeated game launches 3. launcher reads the auth address from `MOONWELL_AUTH_ADDRESS` when configured,
otherwise from `set realmlist <host[:port]>` in `realmlist.wtf`; this file is
never modified and the default auth port is 3724
4. launcher resolves the player's data in `Data/`, falling back to `WoW/Data/`,
and verifies that the ticket still has at least five seconds of validity
5. launcher starts MoonWell with working directory set to the installation root,
no authorization command-line arguments, and these child environment values:
- `WOW_USER=<account>`
- `WOW_PASS=<ticket>`
- `WOW_HOST=<auth-address>`
- `WOW_DATA=<absolute-data-directory>`
- `BENILLA_HOME=<install-root>/benilla-config`
6. launcher retains a process handle; while the process is alive, it disables repeated game launches
and client synchronization and client synchronization
5. when the process exits, the launcher returns to the ready-to-play state 7. when the process exits, the launcher returns to the ready-to-play state
If `Wow.exe` is missing, launch fails with an error. Launching never edits `WTF/Config.wtf` or clears `Cache`. macOS executes the
bundle launcher directly; that script `exec`s MoonWell so the handle follows
the game rather than an `open` helper. Settings remain outside the `.app`.
If the executable, data directory, or auth endpoint is missing or invalid,
launch fails with an error. A consumed ticket cannot authenticate again; close
the client and press Play for a fresh ticket after a session ends.
## Error Behavior ## Error Behavior
@@ -252,7 +286,8 @@ The launcher surfaces errors for:
- checksum mismatch after download - checksum mismatch after download
- missing downloaded temp files before verification - missing downloaded temp files before verification
- final verification mismatch after update - final verification mismatch after update
- missing `Wow.exe` - missing MoonWell executable, WoW data, or game auth endpoint
- invalid, expired, or unavailable game ticket
## Tested Invariants ## Tested Invariants
+21 -1
View File
@@ -22,7 +22,7 @@ release that has not passed the remote download and checksum verification.
The release machine needs: The release machine needs:
- latest stable Flutter and Dart available on `PATH` - latest stable Flutter and Dart selected through FVM
- Inno Setup 6, normally installed at - Inno Setup 6, normally installed at
`C:\Program Files (x86)\Inno Setup 6\ISCC.exe` `C:\Program Files (x86)\Inno Setup 6\ISCC.exe`
- OpenSSL, normally supplied by Git for Windows at - OpenSSL, normally supplied by Git for Windows at
@@ -45,6 +45,13 @@ Back up `.moonwell_signing\dsa_priv.pem` in the project secret store. Never
commit it, upload it to Object Storage, or send it through chat. Losing this key commit it, upload it to Object Storage, or send it through chat. Losing this key
prevents released launchers from accepting future updates. prevents released launchers from accepting future updates.
The deploy script copies the x64 Visual C++ CRT DLLs from Visual Studio's
redistributable directory into the application folder before compiling the
installer. Use `-VcRuntimePath` to override the detected directory. This keeps
the per-user installer usable without installing system runtimes as an admin;
Windows 10/11 supplies the Universal CRT. See Microsoft's
[app-local deployment guidance](https://learn.microsoft.com/en-us/cpp/windows/choosing-a-deployment-method?view=msvc-170).
## Local `.env` ## Local `.env`
For local releases, copy `.env.example` to `.env` and fill in the real values. For local releases, copy `.env.example` to `.env` and fill in the real values.
@@ -125,6 +132,19 @@ The production defaults are:
- installer: - installer:
`https://storage.yandexcloud.net/warcraft-client/moonwell_launcher_setup.exe` `https://storage.yandexcloud.net/warcraft-client/moonwell_launcher_setup.exe`
Use a versioned `-S3Key`, such as
`moonwell_launcher/releases/1.0.4/moonwell_launcher_setup.exe`, to preserve the
installer referenced by each signed AppCast. After the feed has been verified,
publish the same verified installer at `moonwell_launcher_setup.exe` for the
website's stable download link. Set `MOONWELL_CLIENT_OBJECT_KEY` to that key in
the web app when its download button should install the launcher. The game
files use their separate client manifest and release prefix.
For FVM, `-FlutterCommand` and `-DartCommand` can point to local `.cmd` wrappers
that run `call fvm flutter %*` and `call fvm dart %*` respectively and return
`exit /b %errorlevel%`. Keep wrappers inside ignored `build/` and ensure the
FVM executable is on `PATH` or use its absolute path in the wrapper.
On success, the command prints the deployed version, installer URL, SHA-256, On success, the command prints the deployed version, installer URL, SHA-256,
and AppCast URL. The tracked root `appcast.xml` contains the exact feed sent to and AppCast URL. The tracked root `appcast.xml` contains the exact feed sent to
the server. the server.
+6
View File
@@ -44,5 +44,11 @@ Source: "{#MyBuildDir}\*"; DestDir: "{app}"; Excludes: "moonwell_launcher.exe";
Name: "{autoprograms}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}" Name: "{autoprograms}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"
Name: "{autodesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"; Tasks: desktopicon Name: "{autodesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppExeName}"; Tasks: desktopicon
[Registry]
Root: HKCU; Subkey: "Software\Classes\moonwell"; ValueType: string; ValueName: ""; ValueData: "URL:MoonWell Launcher Protocol"; Flags: uninsdeletekey
Root: HKCU; Subkey: "Software\Classes\moonwell"; ValueType: string; ValueName: "URL Protocol"; ValueData: ""
Root: HKCU; Subkey: "Software\Classes\moonwell\DefaultIcon"; ValueType: string; ValueName: ""; ValueData: "{app}\{#MyAppExeName},0"
Root: HKCU; Subkey: "Software\Classes\moonwell\shell\open\command"; ValueType: string; ValueName: ""; ValueData: """{app}\{#MyAppExeName}"" ""%1"""
[Run] [Run]
Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#StringChange(MyAppName, '&', '&&')}}"; Flags: nowait postinstall skipifsilent Filename: "{app}\{#MyAppExeName}"; Description: "{cm:LaunchProgram,{#StringChange(MyAppName, '&', '&&')}}"; Flags: nowait postinstall skipifsilent
+1 -1
View File
@@ -526,7 +526,7 @@ class _HeroCopy extends StatelessWidget {
), ),
const SizedBox(height: 14), const SizedBox(height: 14),
const Text( const Text(
'Wrath of the Lich King · приватный сервер', 'World of Warcraft 1.12.1 · приватный сервер',
style: TextStyle( style: TextStyle(
fontFamily: 'Cormorant Garamond', fontFamily: 'Cormorant Garamond',
fontStyle: FontStyle.italic, fontStyle: FontStyle.italic,
+14 -3
View File
@@ -80,6 +80,7 @@ class HomeScreenBloc extends Bloc<HomeScreenEvent, HomeScreenState> {
Timer? _realmRefreshTimer; Timer? _realmRefreshTimer;
int? _activeGamePid; int? _activeGamePid;
bool _pauseRequested = false; bool _pauseRequested = false;
bool _gameLaunchPending = false;
Future<void> _onHomeScreenLoad( Future<void> _onHomeScreenLoad(
HomeScreenLoad event, HomeScreenLoad event,
@@ -337,17 +338,25 @@ class HomeScreenBloc extends Bloc<HomeScreenEvent, HomeScreenState> {
HomeScreenPlayRequested event, HomeScreenPlayRequested event,
Emitter<HomeScreenState> emit, Emitter<HomeScreenState> emit,
) async { ) async {
if (_gameLaunchPending || state.model.isGameRunning) {
return;
}
final outputPath = state.model.outputPath; final outputPath = state.model.outputPath;
if (outputPath == null) { if (outputPath == null) {
emit(_buildErrorState('Сначала выберите папку установки.')); emit(_buildErrorState('Сначала выберите папку установки.'));
return; return;
} }
_gameLaunchPending = true;
try { try {
final installationDir = outputPath.toFilePath(); final installationDir = outputPath.toFilePath();
await _gameInstallationService.clearCache(installationDir); final authorization = await _launcherApiClient.issueGameTicket(
_session.accessToken,
);
final process = await _gameInstallationService.launchGame( final process = await _gameInstallationService.launchGame(
installationDir, installationDir,
authorization: authorization,
); );
_activeGamePid = process.pid; _activeGamePid = process.pid;
unawaited( unawaited(
@@ -370,7 +379,7 @@ class HomeScreenBloc extends Bloc<HomeScreenEvent, HomeScreenState> {
model: state.model.copyWith( model: state.model.copyWith(
phase: HomeScreenPhase.readyToPlay, phase: HomeScreenPhase.readyToPlay,
isGameRunning: true, isGameRunning: true,
statusText: 'Игра запущена. Папка Cache очищена перед стартом.', statusText: 'MoonWell запущен.',
errorMessage: null, errorMessage: null,
), ),
), ),
@@ -382,6 +391,8 @@ class HomeScreenBloc extends Bloc<HomeScreenEvent, HomeScreenState> {
errorMessage: _formatError(error), errorMessage: _formatError(error),
), ),
); );
} finally {
_gameLaunchPending = false;
} }
} }
@@ -405,7 +416,7 @@ class HomeScreenBloc extends Bloc<HomeScreenEvent, HomeScreenState> {
isGameRunning: false, isGameRunning: false,
statusText: hasClientExecutable statusText: hasClientExecutable
? 'Игра закрыта. Клиент готов к запуску.' ? 'Игра закрыта. Клиент готов к запуску.'
: 'Игра закрыта, но Wow.exe больше не найден.', : 'Игра закрыта, но клиент MoonWell больше не найден.',
errorMessage: null, errorMessage: null,
), ),
), ),
+6 -1
View File
@@ -6,7 +6,11 @@ final class Config {
'MOONWELL_APPCAST_URL', 'MOONWELL_APPCAST_URL',
); );
static const launcherLogFileName = 'launcher.log'; static const launcherLogFileName = 'launcher.log';
static const gameExecutableName = 'Wow.exe'; static const gameExecutableName = 'MoonWell.exe';
static const gameClientBuild = 5875;
static const gameAuthAddress = String.fromEnvironment(
'MOONWELL_AUTH_ADDRESS',
);
static const cacheDirectoryName = 'Cache'; static const cacheDirectoryName = 'Cache';
static const launcherMetadataDirectoryName = '.moonwell_launcher'; static const launcherMetadataDirectoryName = '.moonwell_launcher';
static const hashCacheFileName = 'hash_cache.json'; static const hashCacheFileName = 'hash_cache.json';
@@ -17,6 +21,7 @@ final class Config {
'logs', 'logs',
'screenshots', 'screenshots',
'wtf', 'wtf',
'benilla-config',
'.moonwell_launcher', '.moonwell_launcher',
}; };
} }
@@ -12,6 +12,7 @@ import 'package:moonwell_launcher/features/launcher/domain/entities/client_hash_
import 'package:moonwell_launcher/features/launcher/domain/entities/client_installation_snapshot.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/client_installation_snapshot.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_exception.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_exception.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_game_ticket.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/local_client_file.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/local_client_file.dart';
import 'package:path/path.dart' as p; import 'package:path/path.dart' as p;
@@ -32,6 +33,10 @@ final class GameProcessHandle {
@lazySingleton @lazySingleton
class GameInstallationService { class GameInstallationService {
String get operatingSystem => Platform.operatingSystem;
String get configuredAuthAddress => Config.gameAuthAddress;
Future<ClientInstallationSnapshot> scanInstallation( Future<ClientInstallationSnapshot> scanInstallation(
String installationDir, { String installationDir, {
required ClientManifest manifest, required ClientManifest manifest,
@@ -219,20 +224,84 @@ class GameInstallationService {
await cacheDirectory.create(recursive: true); await cacheDirectory.create(recursive: true);
} }
Future<GameProcessHandle> launchGame(String installationDir) async { Future<void> removeSavedAccountName(String installationDir) async {
final configFile = File(p.join(installationDir, 'WTF', 'Config.wtf'));
if (!await configFile.exists()) {
return;
}
final contents = await configFile.readAsString();
final sanitizedContents = contents.replaceAll(
RegExp(
r'^[ \t]*SET[ \t]+accountName(?:[ \t]+.*)?(?:\r\n|\n|\r|$)',
caseSensitive: false,
multiLine: true,
),
'',
);
if (sanitizedContents != contents) {
await configFile.writeAsString(sanitizedContents, flush: true);
}
}
Future<GameProcessHandle> launchGame(
String installationDir, {
required LauncherGameTicket authorization,
}) async {
final executablePath = getExecutablePath(installationDir); final executablePath = getExecutablePath(installationDir);
final executable = File(executablePath); final executable = File(executablePath);
if (!await executable.exists()) { if (!await executable.exists()) {
throw const LauncherSyncException( throw LauncherSyncException(
'Wow.exe was not found in the selected folder.', 'MoonWell client was not found: $executablePath',
); );
} }
final authAddress = await resolveAuthAddress(installationDir);
final rootPath = p.absolute(installationDir);
final directDataPath = p.join(rootPath, 'Data');
final nestedDataPath = p.join(rootPath, 'WoW', 'Data');
final dataPath = await Directory(directDataPath).exists()
? directDataPath
: nestedDataPath;
if (!await Directory(dataPath).exists()) {
throw const LauncherSyncException(
'WoW 1.12.1 Data or WoW/Data was not found in the selected folder.',
);
}
if (!authorization.isUsable()) {
throw const LauncherSyncException(
'Game ticket has expired. Press Play to request a new ticket.',
);
}
return startGameProcess(
executablePath: executablePath,
arguments: const <String>[],
workingDirectory: rootPath,
environment: <String, String>{
'WOW_USER': authorization.account,
'WOW_PASS': authorization.ticket,
'WOW_HOST': authAddress,
'WOW_DATA': dataPath,
'BENILLA_HOME': p.join(rootPath, 'benilla-config'),
},
);
}
Future<GameProcessHandle> startGameProcess({
required String executablePath,
required List<String> arguments,
required String workingDirectory,
required Map<String, String> environment,
}) async {
final process = await Process.start( final process = await Process.start(
executablePath, executablePath,
const <String>[], arguments,
workingDirectory: installationDir, workingDirectory: workingDirectory,
environment: environment,
includeParentEnvironment: true,
mode: ProcessStartMode.normal, mode: ProcessStartMode.normal,
); );
await process.stdin.close(); await process.stdin.close();
@@ -264,7 +333,56 @@ class GameInstallationService {
} }
String getExecutablePath(String installationDir) { String getExecutablePath(String installationDir) {
return p.join(installationDir, Config.gameExecutableName); final rootPath = p.absolute(installationDir);
return switch (operatingSystem) {
'windows' => p.join(rootPath, Config.gameExecutableName),
'macos' => p.join(
rootPath,
'MoonWell.app',
'Contents',
'MacOS',
'launch',
),
_ => p.join(rootPath, 'MoonWell'),
};
}
/// The auth endpoint is separate from a realm's world port (normally 8085).
Future<String> resolveAuthAddress(String installationDir) async {
final configured = configuredAuthAddress.trim();
if (configured.isNotEmpty) {
return _validateAuthAddress(configured);
}
final realmlist = File(p.join(installationDir, 'realmlist.wtf'));
if (await realmlist.exists()) {
final pattern = RegExp(
r'^\s*set\s+realmlist\s+(?:"([^"]+)"|([^\s]+))\s*(?://.*)?$',
caseSensitive: false,
multiLine: true,
);
final matches = pattern.allMatches(await realmlist.readAsString());
if (matches.isNotEmpty) {
final match = matches.last;
return _validateAuthAddress((match.group(1) ?? match.group(2)!).trim());
}
}
throw const LauncherSyncException(
'Set realmlist in realmlist.wtf or configure MOONWELL_AUTH_ADDRESS.',
);
}
String _validateAuthAddress(String address) {
final match = RegExp(
r'^([A-Za-z0-9][A-Za-z0-9._-]*)(?::([0-9]{1,5}))?$',
).firstMatch(address);
final port = int.tryParse(match?.group(2) ?? '3724');
if (match == null || port == null || port < 1 || port > 65535) {
throw const LauncherSyncException(
'The auth address must be a hostname or IPv4 address with an optional TCP port.',
);
}
return address;
} }
String resolveClientPath(String installationDir, String relativePath) { String resolveClientPath(String installationDir, String relativePath) {
@@ -11,12 +11,15 @@ import 'package:moonwell_launcher/features/launcher/domain/entities/client_manif
import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest_file.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest_file.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_account.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_account.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_exception.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_exception.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_game_ticket.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_news_item.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_news_item.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_realm.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_realm.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_session.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_session.dart';
@lazySingleton @lazySingleton
class LauncherApiClient { class LauncherApiClient {
String get apiBaseUrl => Config.launcherApiBaseUrl;
LauncherApiClient({LauncherLogService? launcherLogService}) LauncherApiClient({LauncherLogService? launcherLogService})
: _launcherLogService = launcherLogService ?? LauncherLogService(), : _launcherLogService = launcherLogService ?? LauncherLogService(),
_dio = Dio( _dio = Dio(
@@ -162,6 +165,47 @@ class LauncherApiClient {
} }
} }
Future<LauncherGameTicket> issueGameTicket(String accessToken) async {
final ticketUri = _resolveUri('api/launcher/game-ticket');
try {
final response = await _dio.postUri(
ticketUri,
data: const <String, Object?>{'client_build': Config.gameClientBuild},
options: _authorizedOptions(accessToken),
);
final ticket = LauncherGameTicket.fromJson(_coerceMap(response.data));
if (!ticket.isUsable()) {
throw const LauncherApiException(
'Launcher API returned an expired game ticket.',
);
}
return ticket;
} on DioException catch (error, stackTrace) {
await _launcherLogService.error(
'Game ticket request failed.',
details: <String, Object?>{
'endpoint': ticketUri.toString(),
'statusCode': error.response?.statusCode,
'dioType': error.type.name,
},
error: error,
stackTrace: stackTrace,
);
throw LauncherApiException(_extractErrorMessage(error));
} on FormatException catch (error, stackTrace) {
await _launcherLogService.error(
'Launcher API returned an invalid game ticket payload.',
details: <String, Object?>{'endpoint': ticketUri.toString()},
error: error,
stackTrace: stackTrace,
);
throw const LauncherApiException(
'Launcher API returned an invalid game ticket.',
);
}
}
Future<ClientManifest> fetchManifest(String accessToken) async { Future<ClientManifest> fetchManifest(String accessToken) async {
final manifestUri = _resolveUri('api/launcher/manifest'); final manifestUri = _resolveUri('api/launcher/manifest');
@@ -383,7 +427,7 @@ class LauncherApiClient {
} }
Uri _resolveUri(String path) { Uri _resolveUri(String path) {
final rawBaseUrl = Config.launcherApiBaseUrl.trim(); final rawBaseUrl = apiBaseUrl.trim();
if (rawBaseUrl.isEmpty) { if (rawBaseUrl.isEmpty) {
throw const LauncherConfigurationException( throw const LauncherConfigurationException(
'Set MOONWELL_API_BASE_URL before using the launcher API.', 'Set MOONWELL_API_BASE_URL before using the launcher API.',
@@ -0,0 +1,53 @@
final class LauncherGameTicket {
static final RegExp _accountPattern = RegExp(r'^[A-Z0-9]{3,16}$');
static final RegExp _ticketPattern = RegExp(r'^[A-Z0-9]{16}$');
final String account;
final String ticket;
final DateTime expiresAt;
const LauncherGameTicket({
required this.account,
required this.ticket,
required this.expiresAt,
});
factory LauncherGameTicket.fromJson(Map<String, dynamic> json) {
final rawAccount = json['account'];
final rawTicket = json['ticket'];
final rawExpiresAt = json['expires_at'];
if (rawAccount is! String ||
rawTicket is! String ||
rawExpiresAt is! String) {
throw const FormatException('Invalid game ticket payload types.');
}
final account = rawAccount;
final ticket = rawTicket;
final expiresAt = DateTime.tryParse(rawExpiresAt);
if (!_accountPattern.hasMatch(account)) {
throw const FormatException('Invalid game ticket account.');
}
if (!_ticketPattern.hasMatch(ticket)) {
throw const FormatException('Invalid game ticket value.');
}
if (expiresAt == null) {
throw const FormatException('Invalid game ticket expiration.');
}
return LauncherGameTicket(
account: account,
ticket: ticket,
expiresAt: expiresAt.toUtc(),
);
}
bool isUsable({
DateTime? now,
Duration minimumValidity = const Duration(seconds: 5),
}) {
final currentTime = (now ?? DateTime.now()).toUtc();
return expiresAt.isAfter(currentTime.add(minimumValidity));
}
}
+77
View File
@@ -109,6 +109,83 @@
} }
} }
}, },
"/api/launcher/game-ticket": {
"post": {
"tags": [
"Launcher Auth"
],
"summary": "Выпустить одноразовый ticket для входа в игру",
"description": "Отзывает предыдущий неиспользованный ticket аккаунта и возвращает временный SRP-пароль. Ticket не сохраняется и действует не более 60 секунд.",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"required": [
"client_build"
],
"properties": {
"client_build": {
"type": "integer",
"example": 12340
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Одноразовая игровая авторизация",
"content": {
"application/json": {
"schema": {
"required": [
"account",
"ticket",
"expires_at"
],
"properties": {
"account": {
"type": "string",
"example": "PLAYERONE",
"maxLength": 17,
"minLength": 1
},
"ticket": {
"type": "string",
"pattern": "^[A-Z0-9]{16}$",
"example": "A1B2C3D4E5F6G7H8"
},
"expires_at": {
"type": "string",
"format": "date-time",
"example": "2026-08-16T12:01:00Z"
}
},
"type": "object"
}
}
}
},
"401": {
"description": "Launcher-сессия отсутствует или истекла"
},
"422": {
"description": "Версия клиента не разрешена"
},
"429": {
"description": "Слишком много запросов"
}
},
"security": [
{
"launcherAuth": []
}
]
}
},
"/api/launcher/manifest": { "/api/launcher/manifest": {
"get": { "get": {
"tags": [ "tags": [
+13 -13
View File
@@ -141,10 +141,10 @@ packages:
dependency: transitive dependency: transitive
description: description:
name: characters name: characters
sha256: f71061c654a3380576a52b451dd5532377954cf9dbd272a78fc8479606670803 sha256: faf38497bda5ead2a8c7615f4f7939df04333478bf32e4173fcb06d428b5716b
url: "https://pub.dev" url: "https://pub.dev"
source: hosted source: hosted
version: "1.4.0" version: "1.4.1"
checked_yaml: checked_yaml:
dependency: transitive dependency: transitive
description: description:
@@ -548,26 +548,26 @@ packages:
dependency: transitive dependency: transitive
description: description:
name: matcher name: matcher
sha256: dc58c723c3c24bf8d3e2d3ad3f2f9d7bd9cf43ec6feaa64181775e60190153f2 sha256: "31bd099b47c10cd1aeb55146a2d46ce0277630ecef3f7dae54ad7873f36696cd"
url: "https://pub.dev" url: "https://pub.dev"
source: hosted source: hosted
version: "0.12.17" version: "0.12.20"
material_color_utilities: material_color_utilities:
dependency: transitive dependency: transitive
description: description:
name: material_color_utilities name: material_color_utilities
sha256: f7142bb1154231d7ea5f96bc7bde4bda2a0945d2806bb11670e30b850d56bdec sha256: "9c337007e82b1889149c82ed242ed1cb24a66044e30979c44912381e9be4c48b"
url: "https://pub.dev" url: "https://pub.dev"
source: hosted source: hosted
version: "0.11.1" version: "0.13.0"
meta: meta:
dependency: transitive dependency: transitive
description: description:
name: meta name: meta
sha256: "23f08335362185a5ea2ad3a4e597f1375e78bce8a040df5c600c8d3552ef2394" sha256: "307249ce4ff29d58a18e97f6345f539382eb9c9c29ecda628900f31de0443dd9"
url: "https://pub.dev" url: "https://pub.dev"
source: hosted source: hosted
version: "1.17.0" version: "1.19.0"
mime: mime:
dependency: transitive dependency: transitive
description: description:
@@ -929,10 +929,10 @@ packages:
dependency: transitive dependency: transitive
description: description:
name: test_api name: test_api
sha256: ab2726c1a94d3176a45960b6234466ec367179b87dd74f1611adb1f3b5fb9d55 sha256: "2a122cbe059f8b610d3a5415f42e255b6c17b1f21eee1d960f31080237fb4f11"
url: "https://pub.dev" url: "https://pub.dev"
source: hosted source: hosted
version: "0.7.7" version: "0.7.12"
typed_data: typed_data:
dependency: transitive dependency: transitive
description: description:
@@ -1009,10 +1009,10 @@ packages:
dependency: transitive dependency: transitive
description: description:
name: vector_math name: vector_math
sha256: d530bd74fea330e6e364cda7a85019c434070188383e1cd8d9777ee586914c5b sha256: "92b9910f66ed1057fd4da7b040ae7c74cafacf885bdc81be496928d5049b032d"
url: "https://pub.dev" url: "https://pub.dev"
source: hosted source: hosted
version: "2.2.0" version: "2.4.3"
vm_service: vm_service:
dependency: transitive dependency: transitive
description: description:
@@ -1102,5 +1102,5 @@ packages:
source: hosted source: hosted
version: "3.1.3" version: "3.1.3"
sdks: sdks:
dart: ">=3.10.3 <4.0.0" dart: ">=3.11.0-0 <4.0.0"
flutter: ">=3.38.4" flutter: ">=3.38.4"
+1 -1
View File
@@ -16,7 +16,7 @@ publish_to: "none" # Remove this line if you wish to publish to pub.dev
# https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
# In Windows, build-name is used as the major, minor, and patch parts # In Windows, build-name is used as the major, minor, and patch parts
# of the product and file versions while build-number is used as the build suffix. # of the product and file versions while build-number is used as the build suffix.
version: 1.0.2+4 version: 1.0.5+8
environment: environment:
sdk: ">=3.10.0" sdk: ">=3.10.0"
@@ -7,10 +7,11 @@ import 'package:moonwell_launcher/features/downloader/domain/entities/download_p
import 'package:moonwell_launcher/features/launcher/application/client_sync_use_case.dart'; import 'package:moonwell_launcher/features/launcher/application/client_sync_use_case.dart';
import 'package:moonwell_launcher/features/launcher/data/game_installation_service.dart'; import 'package:moonwell_launcher/features/launcher/data/game_installation_service.dart';
import 'package:moonwell_launcher/features/launcher/data/launcher_api_client.dart'; import 'package:moonwell_launcher/features/launcher/data/launcher_api_client.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/client_installation_snapshot.dart'; // import 'package:moonwell_launcher/features/launcher/domain/entities/client_installation_snapshot.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/client_sync_status.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/client_sync_status.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_account.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_account.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_game_ticket.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_news_item.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_news_item.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_realm.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_realm.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_session.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_session.dart';
@@ -147,11 +148,15 @@ void main() {
final manifest = ClientManifest.fromJson(<String, Object?>{ final manifest = ClientManifest.fromJson(<String, Object?>{
'files': <Map<String, Object?>>[], 'files': <Map<String, Object?>>[],
}); });
final gameService = _TrackingGameInstallationService(); final launchOperations = <String>[];
final gameService = _TrackingGameInstallationService(launchOperations);
final bloc = HomeScreenBloc( final bloc = HomeScreenBloc(
clientSyncUseCase: _CapturingClientSyncUseCase(), clientSyncUseCase: _CapturingClientSyncUseCase(),
gameInstallationService: gameService, gameInstallationService: gameService,
launcherApiClient: _FakeLauncherApiClient(newsItems: const []), launcherApiClient: _FakeLauncherApiClient(
newsItems: const [],
launchOperations: launchOperations,
),
preferencesRepository: _FakePreferencesRepository( preferencesRepository: _FakePreferencesRepository(
outputDir: Uri.directory('C:/World of Warcraft'), outputDir: Uri.directory('C:/World of Warcraft'),
), ),
@@ -168,6 +173,10 @@ void main() {
await pumpEventQueue(times: 20); await pumpEventQueue(times: 20);
expect(gameService.launchCount, 1); expect(gameService.launchCount, 1);
expect(gameService.savedAccountNameRemovalCount, 0);
expect(launchOperations, <String>['issueGameTicket', 'launchGame']);
expect(gameService.launchedWith?.account, 'PLAYERONE');
expect(gameService.launchedWith?.ticket, 'A1B2C3D4E5F6G7H8');
expect(bloc.state.model.isGameRunning, isTrue); expect(bloc.state.model.isGameRunning, isTrue);
expect(bloc.state.model.canPlay, isFalse); expect(bloc.state.model.canPlay, isFalse);
@@ -227,13 +236,16 @@ class _FakeLauncherApiClient extends LauncherApiClient {
this.manifest, this.manifest,
this.realms = const [], this.realms = const [],
this.account = const LauncherAccount(username: ''), this.account = const LauncherAccount(username: ''),
this.launchOperations,
}); });
final List<LauncherNewsItem> newsItems; final List<LauncherNewsItem> newsItems;
final ClientManifest? manifest; final ClientManifest? manifest;
final List<LauncherRealm> realms; final List<LauncherRealm> realms;
final LauncherAccount account; final LauncherAccount account;
final List<String>? launchOperations;
int manifestRequestCount = 0; int manifestRequestCount = 0;
int gameTicketRequestCount = 0;
@override @override
Future<List<LauncherNewsItem>> fetchNews(String accessToken) async => Future<List<LauncherNewsItem>> fetchNews(String accessToken) async =>
@@ -245,6 +257,17 @@ class _FakeLauncherApiClient extends LauncherApiClient {
@override @override
Future<LauncherAccount> fetchAccount(String accessToken) async => account; Future<LauncherAccount> fetchAccount(String accessToken) async => account;
@override
Future<LauncherGameTicket> issueGameTicket(String accessToken) async {
launchOperations?.add('issueGameTicket');
gameTicketRequestCount += 1;
return LauncherGameTicket(
account: 'PLAYERONE',
ticket: 'A1B2C3D4E5F6G7H8',
expiresAt: DateTime.now().toUtc().add(const Duration(seconds: 60)),
);
}
@override @override
Future<ClientManifest> fetchManifest(String accessToken) async { Future<ClientManifest> fetchManifest(String accessToken) async {
manifestRequestCount += 1; manifestRequestCount += 1;
@@ -259,29 +282,47 @@ class _FakeGameInstallationService extends GameInstallationService {
@override @override
Future<bool> hasClientExecutable(String installationDir) async => false; Future<bool> hasClientExecutable(String installationDir) async => false;
@override // @override
Future<ClientInstallationSnapshot> scanInstallation( // Future<ClientInstallationSnapshot> scanInstallation(
String installationDir, { // String installationDir, {
InstallationScanProgressCallback? onProgress, // InstallationScanProgressCallback? onProgress,
FutureOr<bool> Function()? isCancelled, // FutureOr<bool> Function()? isCancelled,
}) async { // }) async {
return ClientInstallationSnapshot.fromFiles(const []); // return ClientInstallationSnapshot.fromFiles(const []);
} // }
} }
class _TrackingGameInstallationService extends _FakeGameInstallationService { class _TrackingGameInstallationService extends _FakeGameInstallationService {
_TrackingGameInstallationService(this.launchOperations);
final List<String> launchOperations;
final Completer<int> exitCode = Completer<int>(); final Completer<int> exitCode = Completer<int>();
int launchCount = 0; int launchCount = 0;
int savedAccountNameRemovalCount = 0;
LauncherGameTicket? launchedWith;
@override @override
Future<bool> hasClientExecutable(String installationDir) async => true; Future<bool> hasClientExecutable(String installationDir) async => true;
@override @override
Future<void> clearCache(String installationDir) async {} Future<void> removeSavedAccountName(String installationDir) async {
launchOperations.add('removeSavedAccountName');
savedAccountNameRemovalCount += 1;
}
@override @override
Future<GameProcessHandle> launchGame(String installationDir) async { Future<void> clearCache(String installationDir) async {
launchOperations.add('clearCache');
}
@override
Future<GameProcessHandle> launchGame(
String installationDir, {
required LauncherGameTicket authorization,
}) async {
launchOperations.add('launchGame');
launchCount += 1; launchCount += 1;
launchedWith = authorization;
return GameProcessHandle(pid: 42, exitCode: exitCode.future); return GameProcessHandle(pid: 42, exitCode: exitCode.future);
} }
} }
@@ -1,8 +1,8 @@
import 'dart:async'; import 'dart:async';
import 'dart:collection'; // import 'dart:collection';
import 'package:flutter_test/flutter_test.dart'; import 'package:flutter_test/flutter_test.dart';
import 'package:moonwell_launcher/features/downloader/domain/entities/download_progress.dart'; // import 'package:moonwell_launcher/features/downloader/domain/entities/download_progress.dart';
import 'package:moonwell_launcher/features/launcher/application/client_sync_use_case.dart'; import 'package:moonwell_launcher/features/launcher/application/client_sync_use_case.dart';
import 'package:moonwell_launcher/features/launcher/data/game_installation_service.dart'; import 'package:moonwell_launcher/features/launcher/data/game_installation_service.dart';
import 'package:moonwell_launcher/features/launcher/data/launcher_api_client.dart'; import 'package:moonwell_launcher/features/launcher/data/launcher_api_client.dart';
@@ -10,139 +10,140 @@ import 'package:moonwell_launcher/features/launcher/data/launcher_log_service.da
import 'package:moonwell_launcher/features/launcher/domain/entities/client_installation_snapshot.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/client_installation_snapshot.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest_file.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/client_manifest_file.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/client_sync_status.dart'; // import 'package:moonwell_launcher/features/launcher/domain/entities/client_sync_status.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_exception.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_exception.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/local_client_file.dart';
// import 'package:moonwell_launcher/features/launcher/domain/entities/local_client_file.dart';
void main() { void main() {
group('ClientSyncUseCase', () { group('ClientSyncUseCase', () {
test( // test(
'completes without downloads when local snapshot matches manifest', // 'completes without downloads when local snapshot matches manifest',
() async { // () async {
final manifest = _manifestFromFiles([ // final manifest = _manifestFromFiles([
const ClientManifestFile( // const ClientManifestFile(
path: 'Wow.exe', // path: 'Wow.exe',
size: 5, // size: 5,
sha256: 'wow-hash', // sha256: 'wow-hash',
), // ),
const ClientManifestFile( // const ClientManifestFile(
path: 'Data/common.MPQ', // path: 'Data/common.MPQ',
size: 10, // size: 10,
sha256: 'data-hash', // sha256: 'data-hash',
), // ),
]); // ]);
final matchingSnapshot = ClientInstallationSnapshot.fromFiles([ // final matchingSnapshot = ClientInstallationSnapshot.fromFiles([
const LocalClientFile(path: 'Wow.exe', size: 5, sha256: 'wow-hash'), // const LocalClientFile(path: 'Wow.exe', size: 5, sha256: 'wow-hash'),
const LocalClientFile( // const LocalClientFile(
path: 'Data/common.MPQ', // path: 'Data/common.MPQ',
size: 10, // size: 10,
sha256: 'data-hash', // sha256: 'data-hash',
), // ),
]); // ]);
final api = _FakeLauncherApiClient(manifest); // final api = _FakeLauncherApiClient(manifest);
final installationService = _FakeGameInstallationService([ // final installationService = _FakeGameInstallationService([
matchingSnapshot, // matchingSnapshot,
]); // ]);
final logger = _FakeLauncherLogService(); // final logger = _FakeLauncherLogService();
final useCase = ClientSyncUseCase( // final useCase = ClientSyncUseCase(
launcherApiClient: api, // launcherApiClient: api,
installationService: installationService, // installationService: installationService,
launcherLogService: logger, // launcherLogService: logger,
); // );
final statuses = await useCase // final statuses = await useCase
.call( // .call(
ClientSyncUseCaseInput( // ClientSyncUseCaseInput(
request: ClientSyncRequest( // request: ClientSyncRequest(
installationDir: 'C:/MoonWell', // installationDir: 'C:/MoonWell',
accessToken: 'token', // accessToken: 'token',
manifest: manifest, // manifest: manifest,
), // ),
), // ),
) // )
.toList(); // .toList();
expect(statuses.last.stage, ClientSyncStage.completed); // expect(statuses.last.stage, ClientSyncStage.completed);
expect(statuses.last.message, 'Клиент обновлён.'); // expect(statuses.last.message, 'Клиент обновлён.');
expect(api.downloadedPaths, isEmpty); // expect(api.downloadedPaths, isEmpty);
expect(installationService.deletedRelativeFiles, isEmpty); // expect(installationService.deletedRelativeFiles, isEmpty);
expect(logger.errorMessages, isEmpty); // expect(logger.errorMessages, isEmpty);
}, // },
); // );
test( // test(
'removes stale files and downloads changed files before final verify', // 'removes stale files and downloads changed files before final verify',
() async { // () async {
final manifest = _manifestFromFiles([ // final manifest = _manifestFromFiles([
const ClientManifestFile( // const ClientManifestFile(
path: 'Wow.exe', // path: 'Wow.exe',
size: 5, // size: 5,
sha256: 'wow-hash', // sha256: 'wow-hash',
), // ),
const ClientManifestFile( // const ClientManifestFile(
path: 'Data/common.MPQ', // path: 'Data/common.MPQ',
size: 10, // size: 10,
sha256: 'data-hash', // sha256: 'data-hash',
), // ),
]); // ]);
final initialSnapshot = ClientInstallationSnapshot.fromFiles([ // final initialSnapshot = ClientInstallationSnapshot.fromFiles([
const LocalClientFile(path: 'Wow.exe', size: 5, sha256: 'old-wow'), // const LocalClientFile(path: 'Wow.exe', size: 5, sha256: 'old-wow'),
const LocalClientFile(path: 'legacy.txt', size: 2, sha256: 'legacy'), // const LocalClientFile(path: 'legacy.txt', size: 2, sha256: 'legacy'),
]); // ]);
final verifiedSnapshot = ClientInstallationSnapshot.fromFiles([ // final verifiedSnapshot = ClientInstallationSnapshot.fromFiles([
const LocalClientFile(path: 'Wow.exe', size: 5, sha256: 'wow-hash'), // const LocalClientFile(path: 'Wow.exe', size: 5, sha256: 'wow-hash'),
const LocalClientFile( // const LocalClientFile(
path: 'Data/common.MPQ', // path: 'Data/common.MPQ',
size: 10, // size: 10,
sha256: 'data-hash', // sha256: 'data-hash',
), // ),
]); // ]);
final api = _FakeLauncherApiClient(manifest); // final api = _FakeLauncherApiClient(manifest);
final installationService = // final installationService =
_FakeGameInstallationService([initialSnapshot, verifiedSnapshot]) // _FakeGameInstallationService([initialSnapshot, verifiedSnapshot])
..fileSizesByPath['C:/MoonWell/Wow.exe.moonwell.part'] = 5 // ..fileSizesByPath['C:/MoonWell/Wow.exe.moonwell.part'] = 5
..computedHashesByPath['C:/MoonWell/Wow.exe.moonwell.part'] = // ..computedHashesByPath['C:/MoonWell/Wow.exe.moonwell.part'] =
'wow-hash' // 'wow-hash'
..fileSizesByPath['C:/MoonWell/Data/common.MPQ.moonwell.part'] = // ..fileSizesByPath['C:/MoonWell/Data/common.MPQ.moonwell.part'] =
10 // 10
..computedHashesByPath['C:/MoonWell/Data/common.MPQ.moonwell.part'] = // ..computedHashesByPath['C:/MoonWell/Data/common.MPQ.moonwell.part'] =
'data-hash'; // 'data-hash';
final logger = _FakeLauncherLogService(); // final logger = _FakeLauncherLogService();
final useCase = ClientSyncUseCase( // final useCase = ClientSyncUseCase(
launcherApiClient: api, // launcherApiClient: api,
installationService: installationService, // installationService: installationService,
launcherLogService: logger, // launcherLogService: logger,
); // );
final statuses = await useCase // final statuses = await useCase
.call( // .call(
ClientSyncUseCaseInput( // ClientSyncUseCaseInput(
request: ClientSyncRequest( // request: ClientSyncRequest(
installationDir: 'C:/MoonWell', // installationDir: 'C:/MoonWell',
accessToken: 'token', // accessToken: 'token',
manifest: manifest, // manifest: manifest,
), // ),
), // ),
) // )
.toList(); // .toList();
expect( // expect(
statuses.map((status) => status.stage), // statuses.map((status) => status.stage),
containsAll([ // containsAll([
ClientSyncStage.removingStaleFiles, // ClientSyncStage.removingStaleFiles,
ClientSyncStage.downloadingFiles, // ClientSyncStage.downloadingFiles,
ClientSyncStage.verifyingInstallation, // ClientSyncStage.verifyingInstallation,
ClientSyncStage.completed, // ClientSyncStage.completed,
]), // ]),
); // );
expect(installationService.deletedRelativeFiles, ['legacy.txt']); // expect(installationService.deletedRelativeFiles, ['legacy.txt']);
expect(api.downloadedPaths, ['Wow.exe', 'Data/common.MPQ']); // expect(api.downloadedPaths, ['Wow.exe', 'Data/common.MPQ']);
expect(statuses.last.message, 'Клиент готов к игре.'); // expect(statuses.last.message, 'Клиент готов к игре.');
expect(logger.errorMessages, isEmpty); // expect(logger.errorMessages, isEmpty);
}, // },
); // );
test( test(
'preserves failed temporary file and returns a log hint on verification mismatch', 'preserves failed temporary file and returns a log hint on verification mismatch',
@@ -243,10 +244,8 @@ class _FakeLauncherApiClient extends LauncherApiClient {
} }
class _FakeGameInstallationService extends GameInstallationService { class _FakeGameInstallationService extends GameInstallationService {
_FakeGameInstallationService(List<ClientInstallationSnapshot> snapshots) _FakeGameInstallationService(List<ClientInstallationSnapshot> snapshots);
: _snapshots = Queue.of(snapshots);
final Queue<ClientInstallationSnapshot> _snapshots;
final List<String> ensuredParentDirectories = []; final List<String> ensuredParentDirectories = [];
final List<String> deletedRelativeFiles = []; final List<String> deletedRelativeFiles = [];
final List<String> deletedFiles = []; final List<String> deletedFiles = [];
@@ -255,34 +254,34 @@ class _FakeGameInstallationService extends GameInstallationService {
final Map<String, String> computedHashesByPath = {}; final Map<String, String> computedHashesByPath = {};
final Map<String, int?> fileSizesByPath = {}; final Map<String, int?> fileSizesByPath = {};
@override // @override
Future<ClientInstallationSnapshot> scanInstallation( // Future<ClientInstallationSnapshot> scanInstallation(
String installationDir, { // String installationDir, {
InstallationScanProgressCallback? onProgress, // InstallationScanProgressCallback? onProgress,
FutureOr<bool> Function()? isCancelled, // FutureOr<bool> Function()? isCancelled,
}) async { // }) async {
final snapshot = _snapshots.removeFirst(); // final snapshot = _snapshots.removeFirst();
var processedFiles = 0; // var processedFiles = 0;
var processedBytes = 0; // var processedBytes = 0;
for (final file in snapshot.files) { // for (final file in snapshot.files) {
processedFiles += 1; // processedFiles += 1;
processedBytes += file.size; // processedBytes += file.size;
onProgress?.call( // onProgress?.call(
DownloadProgress( // DownloadProgress(
speed: 0, // speed: 0,
downloaded: processedBytes, // downloaded: processedBytes,
total: snapshot.files.fold<int>(0, (sum, item) => sum + item.size), // total: snapshot.files.fold<int>(0, (sum, item) => sum + item.size),
eta: Duration.zero, // eta: Duration.zero,
), // ),
file.path, // file.path,
processedFiles, // processedFiles,
snapshot.files.length, // snapshot.files.length,
); // );
} // }
return snapshot; // return snapshot;
} // }
@override @override
Future<void> deleteRelativeFile( Future<void> deleteRelativeFile(
@@ -1,10 +1,11 @@
import 'dart:io'; import 'dart:io';
import 'package:flutter_test/flutter_test.dart'; import 'package:flutter_test/flutter_test.dart';
import 'package:moonwell_launcher/config.dart'; // import 'package:moonwell_launcher/config.dart';
import 'package:moonwell_launcher/features/launcher/data/game_installation_service.dart'; import 'package:moonwell_launcher/features/launcher/data/game_installation_service.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/client_hash_entry.dart'; // import 'package:moonwell_launcher/features/launcher/domain/entities/client_hash_entry.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_exception.dart'; import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_exception.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_game_ticket.dart';
void main() { void main() {
group('GameInstallationService', () { group('GameInstallationService', () {
@@ -12,14 +13,17 @@ void main() {
late GameInstallationService service; late GameInstallationService service;
setUp(() async { setUp(() async {
service = GameInstallationService(); service = _RecordingGameInstallationService();
rootDirectory = await Directory.systemTemp.createTemp( rootDirectory = await Directory.systemTemp.createTemp(
'moonwell_launcher_', 'moonwell_launcher_',
); );
await File( await File(
'${rootDirectory.path}${Platform.pathSeparator}Wow.exe', service.getExecutablePath(rootDirectory.path),
).writeAsString('wow'); ).writeAsString('moonwell');
await File(
'${rootDirectory.path}${Platform.pathSeparator}realmlist.wtf',
).writeAsString('set realmlist 127.0.0.1:3724\n');
await Directory( await Directory(
'${rootDirectory.path}${Platform.pathSeparator}Data', '${rootDirectory.path}${Platform.pathSeparator}Data',
).create(recursive: true); ).create(recursive: true);
@@ -48,37 +52,37 @@ void main() {
} }
}); });
test('scanInstallation ignores excluded directories', () async { // test('scanInstallation ignores excluded directories', () async {
final snapshot = await service.scanInstallation(rootDirectory.path); // final snapshot = await service.scanInstallation(rootDirectory.path);
final paths = snapshot.files.map((file) => file.path).toList()..sort(); // final paths = snapshot.files.map((file) => file.path).toList()..sort();
expect(paths, ['Data/common.MPQ', 'Wow.exe']); // expect(paths, ['Data/common.MPQ', 'Wow.exe']);
expect(snapshot.buildHash, computeBuildHash(snapshot.files)); // expect(snapshot.buildHash, computeBuildHash(snapshot.files));
}); // });
test( // test(
'scanInstallation creates launcher hash cache outside verification set', // 'scanInstallation creates launcher hash cache outside verification set',
() async { // () async {
await service.scanInstallation(rootDirectory.path); // await service.scanInstallation(rootDirectory.path);
final cacheFile = File(service.getHashCachePath(rootDirectory.path)); // final cacheFile = File(service.getHashCachePath(rootDirectory.path));
expect(await cacheFile.exists(), isTrue); // expect(await cacheFile.exists(), isTrue);
final secondSnapshot = await service.scanInstallation( // final secondSnapshot = await service.scanInstallation(
rootDirectory.path, // rootDirectory.path,
); // );
final paths = secondSnapshot.files.map((file) => file.path).toList() // final paths = secondSnapshot.files.map((file) => file.path).toList()
..sort(); // ..sort();
expect(paths, ['Data/common.MPQ', 'Wow.exe']); // expect(paths, ['Data/common.MPQ', 'Wow.exe']);
expect( // expect(
await Directory( // await Directory(
'${rootDirectory.path}${Platform.pathSeparator}${Config.launcherMetadataDirectoryName}', // '${rootDirectory.path}${Platform.pathSeparator}${Config.launcherMetadataDirectoryName}',
).exists(), // ).exists(),
isTrue, // isTrue,
); // );
}, // },
); // );
test('clearCache recreates an empty cache directory', () async { test('clearCache recreates an empty cache directory', () async {
await service.clearCache(rootDirectory.path); await service.clearCache(rootDirectory.path);
@@ -91,6 +95,30 @@ void main() {
expect(await cacheDirectory.list().isEmpty, isTrue); expect(await cacheDirectory.list().isEmpty, isTrue);
}); });
test('removeSavedAccountName removes accountName lines only', () async {
final configFile = File(
'${rootDirectory.path}${Platform.pathSeparator}WTF${Platform.pathSeparator}Config.wtf',
);
await configFile.parent.create(recursive: true);
await configFile.writeAsString(
'SET gxWindow "1"\r\n'
'SET accountName "admin#&|&#123456#&|&#0"\r\n'
'set ACCOUNTNAME "another account"\r\n'
'SET locale "ruRU"\r\n',
);
await service.removeSavedAccountName(rootDirectory.path);
expect(
await configFile.readAsString(),
'SET gxWindow "1"\r\nSET locale "ruRU"\r\n',
);
});
test('removeSavedAccountName ignores a missing Config.wtf', () async {
await service.removeSavedAccountName(rootDirectory.path);
});
test('ensureParentDirectoryExists creates nested directories', () async { test('ensureParentDirectoryExists creates nested directories', () async {
final tempPath = final tempPath =
'${rootDirectory.path}${Platform.pathSeparator}Data${Platform.pathSeparator}patches${Platform.pathSeparator}common-2.MPQ.moonwell.part'; '${rootDirectory.path}${Platform.pathSeparator}Data${Platform.pathSeparator}patches${Platform.pathSeparator}common-2.MPQ.moonwell.part';
@@ -125,5 +153,225 @@ void main() {
throwsA(isA<LauncherSyncException>()), throwsA(isA<LauncherSyncException>()),
); );
}); });
test(
'launchGame passes authorization only through child environment',
() async {
final recordingService = _RecordingGameInstallationService();
final authorization = LauncherGameTicket(
account: 'PLAYERONE',
ticket: 'A1B2C3D4E5F6G7H8',
expiresAt: DateTime.now().toUtc().add(const Duration(seconds: 60)),
);
await recordingService.launchGame(
rootDirectory.path,
authorization: authorization,
);
expect(recordingService.arguments, isEmpty);
expect(
recordingService.executablePath,
service.getExecutablePath(rootDirectory.path),
);
expect(recordingService.workingDirectory, rootDirectory.path);
expect(recordingService.environment, <String, String>{
'WOW_USER': 'PLAYERONE',
'WOW_PASS': 'A1B2C3D4E5F6G7H8',
'WOW_HOST': '127.0.0.1:3724',
'WOW_DATA': '${rootDirectory.path}${Platform.pathSeparator}Data',
'BENILLA_HOME':
'${rootDirectory.path}${Platform.pathSeparator}benilla-config',
});
expect(
await File(
'${rootDirectory.path}${Platform.pathSeparator}realmlist.wtf',
).readAsString(),
'set realmlist 127.0.0.1:3724\n',
);
expect(
await File(
'${rootDirectory.path}${Platform.pathSeparator}Cache${Platform.pathSeparator}cache.bin',
).readAsString(),
'cache',
);
},
);
test(
'macOS starts the app launcher and keeps state outside the bundle',
() async {
final recordingService = _RecordingGameInstallationService(
platform: 'macos',
);
final executable = File(
recordingService.getExecutablePath(rootDirectory.path),
);
await executable.parent.create(recursive: true);
await executable.writeAsString('#!/bin/sh\n');
await recordingService.launchGame(
rootDirectory.path,
authorization: _validTicket(),
);
expect(recordingService.executablePath, executable.path);
expect(
recordingService.environment?['BENILLA_HOME'],
'${rootDirectory.path}${Platform.pathSeparator}benilla-config',
);
expect(recordingService.arguments, isEmpty);
},
);
test('uses WoW/Data when the install has a nested Data directory', () async {
await Directory(
'${rootDirectory.path}${Platform.pathSeparator}Data',
).rename('${rootDirectory.path}${Platform.pathSeparator}WoW');
final nestedData = Directory(
'${rootDirectory.path}${Platform.pathSeparator}WoW${Platform.pathSeparator}Data',
);
await nestedData.create();
final recordingService = _RecordingGameInstallationService();
await recordingService.launchGame(
rootDirectory.path,
authorization: _validTicket(),
);
expect(recordingService.environment?['WOW_DATA'], nestedData.path);
});
test('configured auth address overrides the install realmlist', () async {
final configured = _RecordingGameInstallationService(
authAddress: 'login.example:3725',
);
expect(
await configured.resolveAuthAddress(rootDirectory.path),
'login.example:3725',
);
});
test('reads a quoted realmlist with CRLF without modifying it', () async {
final file = File(
'${rootDirectory.path}${Platform.pathSeparator}realmlist.wtf',
);
await file.writeAsString('SET REALMLIST "login.example:3724"\r\n');
expect(
await service.resolveAuthAddress(rootDirectory.path),
'login.example:3724',
);
expect(
await file.readAsString(),
'SET REALMLIST "login.example:3724"\r\n',
);
});
test('rejects missing or malformed auth endpoints', () async {
final file = File(
'${rootDirectory.path}${Platform.pathSeparator}realmlist.wtf',
);
await file.delete();
await expectLater(
service.resolveAuthAddress(rootDirectory.path),
throwsA(isA<LauncherSyncException>()),
);
for (final address in [
'https://login.example',
'login.example:0',
'login.example:65536',
]) {
final configured = _RecordingGameInstallationService(
authAddress: address,
);
await expectLater(
configured.resolveAuthAddress(rootDirectory.path),
throwsA(isA<LauncherSyncException>()),
);
}
});
test('does not start a process with an expired ticket', () async {
final recordingService = _RecordingGameInstallationService();
await expectLater(
recordingService.launchGame(
rootDirectory.path,
authorization: LauncherGameTicket(
account: 'PLAYERONE',
ticket: 'A1B2C3D4E5F6G7H8',
expiresAt: DateTime.utc(2020),
),
),
throwsA(isA<LauncherSyncException>()),
);
expect(recordingService.environment, isNull);
});
test(
'does not launch a missing client or an installation without data',
() async {
final recordingService = _RecordingGameInstallationService();
final executable = File(
recordingService.getExecutablePath(rootDirectory.path),
);
await executable.delete();
await expectLater(
recordingService.launchGame(
rootDirectory.path,
authorization: _validTicket(),
),
throwsA(isA<LauncherSyncException>()),
);
await executable.writeAsString('moonwell');
await Directory(
'${rootDirectory.path}${Platform.pathSeparator}Data',
).delete(recursive: true);
await expectLater(
recordingService.launchGame(
rootDirectory.path,
authorization: _validTicket(),
),
throwsA(isA<LauncherSyncException>()),
);
expect(recordingService.environment, isNull);
},
);
}); });
} }
LauncherGameTicket _validTicket() => LauncherGameTicket(
account: 'PLAYERONE',
ticket: 'A1B2C3D4E5F6G7H8',
expiresAt: DateTime.now().toUtc().add(const Duration(seconds: 60)),
);
final class _RecordingGameInstallationService extends GameInstallationService {
_RecordingGameInstallationService({
this.platform = 'windows',
this.authAddress = '',
});
final String platform;
final String authAddress;
@override
String get operatingSystem => platform;
@override
String get configuredAuthAddress => authAddress;
Map<String, String>? environment;
List<String>? arguments;
String? executablePath;
String? workingDirectory;
@override
Future<GameProcessHandle> startGameProcess({
required String executablePath,
required List<String> arguments,
required String workingDirectory,
required Map<String, String> environment,
}) async {
this.arguments = List<String>.from(arguments);
this.environment = Map<String, String>.from(environment);
this.executablePath = executablePath;
this.workingDirectory = workingDirectory;
return GameProcessHandle(pid: 42, exitCode: Future<int>.value(0));
}
}
@@ -0,0 +1,48 @@
import 'dart:convert';
import 'dart:io';
import 'package:flutter_test/flutter_test.dart';
import 'package:moonwell_launcher/features/launcher/data/launcher_api_client.dart';
void main() {
test('requests a Vanilla game ticket with bearer authentication', () async {
final server = await HttpServer.bind(InternetAddress.loopbackIPv4, 0);
addTearDown(() => server.close(force: true));
final client = _LocalLauncherApiClient(server.port);
final ticketFuture = client.issueGameTicket('test-launcher-token');
final request = await server.first;
expect(request.method, 'POST');
expect(request.uri.path, '/api/launcher/game-ticket');
expect(
request.headers.value(HttpHeaders.authorizationHeader),
'Bearer test-launcher-token',
);
expect(jsonDecode(await utf8.decoder.bind(request).join()), {
'client_build': 5875,
});
request.response.headers.contentType = ContentType.json;
request.response.write(
jsonEncode({
'account': 'PLAYERONE',
'ticket': 'A1B2C3D4E5F6G7H8',
'expires_at': DateTime.now()
.toUtc()
.add(const Duration(seconds: 60))
.toIso8601String(),
}),
);
await request.response.close();
final ticket = await ticketFuture;
expect(ticket.account, 'PLAYERONE');
expect(ticket.ticket, 'A1B2C3D4E5F6G7H8');
});
}
class _LocalLauncherApiClient extends LauncherApiClient {
_LocalLauncherApiClient(this.port);
final int port;
@override
String get apiBaseUrl => 'http://127.0.0.1:$port';
}
@@ -0,0 +1,79 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:moonwell_launcher/features/launcher/domain/entities/launcher_game_ticket.dart';
void main() {
group('LauncherGameTicket', () {
test('parses the launcher authorization contract', () {
final ticket = LauncherGameTicket.fromJson(<String, Object?>{
'account': 'PLAYERONE',
'ticket': 'A1B2C3D4E5F6G7H8',
'expires_at': '2026-08-16T12:01:00Z',
});
expect(ticket.account, 'PLAYERONE');
expect(ticket.ticket, 'A1B2C3D4E5F6G7H8');
expect(ticket.expiresAt, DateTime.utc(2026, 8, 16, 12, 1));
});
test('rejects tickets outside the native client format', () {
expect(
() => LauncherGameTicket.fromJson(<String, Object?>{
'account': 'PLAYERONE',
'ticket': 'lowercase-ticket',
'expires_at': '2026-08-16T12:01:00Z',
}),
throwsFormatException,
);
});
test('does not normalize credentials from the API', () {
expect(
() => LauncherGameTicket.fromJson(<String, Object?>{
'account': 'PLAYER ',
'ticket': ' A1B2C3D4E5F6G7H8',
'expires_at': '2026-08-16T12:01:00Z',
}),
throwsFormatException,
);
});
test('rejects accounts incompatible with the web 1.12.1 contract', () {
for (final account in [
'AB',
'ABCDEFGHIJKLMNOPQ',
'PLAYER_NAME',
'playerone',
]) {
expect(
() => LauncherGameTicket.fromJson(<String, Object?>{
'account': account,
'ticket': 'A1B2C3D4E5F6G7H8',
'expires_at': '2026-08-16T12:01:00Z',
}),
throwsFormatException,
);
}
});
test('requires enough validity to start the game', () {
final ticket = LauncherGameTicket(
account: 'PLAYERONE',
ticket: 'A1B2C3D4E5F6G7H8',
expiresAt: DateTime.utc(2026, 8, 16, 12, 0, 4),
);
expect(ticket.isUsable(now: DateTime.utc(2026, 8, 16, 12)), isFalse);
});
});
test('rejects non-string payload fields with a format exception', () {
expect(
() => LauncherGameTicket.fromJson(<String, dynamic>{
'account': 42,
'ticket': 'ABCDEFGH12345678',
'expires_at': '2026-08-16T20:00:00Z',
}),
throwsFormatException,
);
});
}
+22
View File
@@ -52,6 +52,7 @@ param(
[string]$DartCommand = 'dart', [string]$DartCommand = 'dart',
[string]$InnoSetupCommand, [string]$InnoSetupCommand,
[string]$OpenSslCommand, [string]$OpenSslCommand,
[string]$VcRuntimePath,
[switch]$SkipChecks, [switch]$SkipChecks,
[switch]$DryRun, [switch]$DryRun,
[switch]$Force [switch]$Force
@@ -519,6 +520,27 @@ try {
"--dart-define=MOONWELL_APPCAST_URL=$AppcastUrl" "--dart-define=MOONWELL_APPCAST_URL=$AppcastUrl"
) )
Write-Step 'Bundling the x64 Visual C++ runtime'
if ([string]::IsNullOrWhiteSpace($VcRuntimePath)) {
$vswherePath = Join-Path ${env:ProgramFiles(x86)} 'Microsoft Visual Studio\Installer\vswhere.exe'
$vsInstall = (& $vswherePath -latest -products '*' -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath).Trim()
if ($LASTEXITCODE -ne 0 -or -not $vsInstall) {
throw 'Visual Studio C++ runtime was not found; pass -VcRuntimePath.'
}
$redistVersion = Get-ChildItem -LiteralPath (Join-Path $vsInstall 'VC\Redist\MSVC') -Directory |
Where-Object { $_.Name -match '^\d+\.\d+\.\d+$' } |
Sort-Object { [version]$_.Name } -Descending | Select-Object -First 1
$VcRuntimePath = Join-Path $redistVersion.FullName 'x64\Microsoft.VC143.CRT'
}
foreach ($requiredDll in @('msvcp140.dll', 'vcruntime140.dll', 'vcruntime140_1.dll')) {
if (-not (Test-Path -LiteralPath (Join-Path $VcRuntimePath $requiredDll) -PathType Leaf)) {
throw "The x64 Visual C++ redistributable $requiredDll was not found."
}
}
Get-ChildItem -LiteralPath $VcRuntimePath -Filter '*.dll' -File | ForEach-Object {
Copy-Item -LiteralPath $_.FullName -Destination 'build\windows\x64\runner\Release'
}
Write-Step 'Building the Inno Setup installer' Write-Step 'Building the Inno Setup installer'
Invoke-RequiredCommand -Command $innoSetup -Arguments @( Invoke-RequiredCommand -Command $innoSetup -Arguments @(
"/DMyAppVersion=$version", "/DMyAppVersion=$version",