New launch

.github/scripts/prepare-sdk-source.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+component="${1:?usage: prepare-sdk-source.sh <component> [expected-file]}"
+expected="${2:-}"
+repo_root="$(git rev-parse --show-toplevel)"
+sdk_dir="${SDK_DIR:-${repo_root}/SDK}"
+target="${sdk_dir}/github_source/${component}"
+
+if [[ -n "${expected}" && -f "${target}/${expected}" ]]; then
+  exit 0
+fi
+
+if [[ -z "${expected}" && -e "${target}" ]]; then
+  exit 0
+fi
+
+export SDK_PATH="${sdk_dir}"
+export GIT_REPO_PATH="${sdk_dir}/github_source"
+export CONFIG_REPO_AUTOMATION="${CONFIG_REPO_AUTOMATION:-y}"
+
+"${PYTHON:-python3}" - "${component}" <<'PY'
+import os
+import sys
+from pathlib import Path
+
+component = sys.argv[1]
+sdk = Path(os.environ["SDK_PATH"])
+source_list = sdk / "github_source" / "source-list.sh"
+
+if not source_list.exists():
+    raise SystemExit(f"SDK source list not found: {source_list}")
+
+class Env(dict):
+    def Fatal(self, message):
+        raise RuntimeError(message)
+
+env = Env()
+env["PROJECT_TOOL_S"] = str(sdk / "tools" / "scons" / "SConstruct_tool.py")
+env["component_dir"] = os.getcwd()
+env["GIT_REPO_LISTS"] = {}
+env["COMPONENTS"] = []
+
+for line in source_list.read_text().splitlines():
+    stripped = line.strip()
+    if not stripped or stripped.startswith("#"):
+        continue
+    parts = stripped.split()
+    if len(parts) < 3 or parts[0] != "git_clone_and_checkout_commit":
+        continue
+    url, commit = parts[1], parts[2]
+    name = url.rstrip("/").removesuffix(".git").split("/")[-1]
+    env["GIT_REPO_LISTS"][name] = {
+        "url": url,
+        "commit": commit,
+        "path": str(sdk / "github_source" / name),
+    }
+
+def Dir(path):
+    return path
+
+def File(path):
+    return path
+
+def Glob(path):
+    return []
+
+with open(env["PROJECT_TOOL_S"], encoding="utf-8") as f:
+    exec(f.read(), globals(), globals())
+
+check_component(component)
+PY

.github/workflows/emulator-build.yml

@@ -19,6 +19,14 @@ jobs:
     runs-on: macos-latest
     steps:
     - uses: actions/checkout@v4
+    - name: Initialize SDK submodule
+      run: git submodule update --init --depth=1 SDK
+    - name: Install SDK Python dependencies
+      run: python3 -m pip install --user --break-system-packages parse requests tqdm
+    - name: Prepare SDK eventpp source
+      run: |
+        cd projects/APPLaunch
+        bash ../../.github/scripts/prepare-sdk-source.sh eventpp include/eventpp/callbacklist.h
     - name: Clone LVGL
       run: |
         git clone --depth 1 --branch v9.5.0 https://github.com/lvgl/lvgl.git projects/CardputerZero-Emulator/lib/lvgl
@@ -49,6 +57,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
+    - name: Initialize SDK submodule
+      run: git submodule update --init --depth=1 SDK
+    - name: Install SDK Python dependencies
+      run: python3 -m pip install --user --break-system-packages parse requests tqdm
+    - name: Prepare SDK eventpp source
+      run: |
+        cd projects/APPLaunch
+        bash ../../.github/scripts/prepare-sdk-source.sh eventpp include/eventpp/callbacklist.h
     - name: Clone LVGL
       run: |
         git clone --depth 1 --branch v9.5.0 https://github.com/lvgl/lvgl.git projects/CardputerZero-Emulator/lib/lvgl
@@ -93,9 +109,18 @@ jobs:
           mingw-w64-x86_64-SDL2_image
           mingw-w64-x86_64-freetype
           mingw-w64-x86_64-winpthreads-git
+          mingw-w64-x86_64-python-pip
           make
           git
     - uses: actions/checkout@v4
+    - name: Initialize SDK submodule
+      run: git submodule update --init --depth=1 SDK
+    - name: Install SDK Python dependencies
+      run: python -m pip install --break-system-packages parse requests tqdm
+    - name: Prepare SDK eventpp source
+      run: |
+        cd projects/APPLaunch
+        PYTHON=python bash ../../.github/scripts/prepare-sdk-source.sh eventpp include/eventpp/callbacklist.h
     - name: Clone LVGL
       run: |
         git clone --depth 1 --branch v9.5.0 https://github.com/lvgl/lvgl.git projects/CardputerZero-Emulator/lib/lvgl
@@ -127,6 +152,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
+    - name: Initialize SDK submodule
+      run: git submodule update --init --depth=1 SDK
+    - name: Install SDK Python dependencies
+      run: python3 -m pip install --user --break-system-packages parse requests tqdm
+    - name: Prepare SDK eventpp source
+      run: |
+        cd projects/APPLaunch
+        bash ../../.github/scripts/prepare-sdk-source.sh eventpp include/eventpp/callbacklist.h
     - name: Clone LVGL
       run: |
         git clone --depth 1 --branch v9.5.0 https://github.com/lvgl/lvgl.git projects/CardputerZero-Emulator/lib/lvgl

.github/workflows/launcher-build.yml

@@ -12,6 +12,7 @@ on:
       - 'SDK/**'
       - '.gitmodules'
       - '.github/workflows/launcher-build.yml'
+      - 'scripts/debian_packager.py'
   pull_request:
     branches: [master]
   workflow_dispatch:
@@ -99,8 +100,7 @@ jobs:
 
     - name: Build .deb package
       run: |
-        cd projects/APPLaunch/tools
-        python3 llm_pack.py
+        python3 scripts/debian_packager.py
 
     - name: Collect artifacts
       run: |

.gitignore

@@ -9,10 +9,11 @@ doc
 tools
 setup.ini
 pi
-projects/APPLaunch/main/ui/components/page_app.h
+projects/APPLaunch/main/ui/page_app.h
 .agents
 dist.bak
 data
 docs/*.html
 skills-lock.json
-*.bak
+*.bak
+projects/APPLaunch/docs/UILaunchPage_carousel_animation.html

README.md

@@ -1,6 +1,6 @@
 # launcher
 
-[中文](./README_ZH.md)
+[中文](./README_ZH.md) | [日本語](./README_JA.md)
 
 A collection of M5CardputerZero applications developed with the [M5Stack_Linux_Libs](https://github.com/m5stack/M5Stack_Linux_Libs) SDK. This project demonstrates how to build graphical UI applications with **LVGL 9.5** on the M5CardputerZero (AArch64 Linux) device.
 
@@ -26,30 +26,30 @@ launcher/
 │   │   ├── SConstruct          # Top-level project build script
 │   │   ├── config_defaults.mk  # Default build config (Linux Framebuffer mode)
 │   │   ├── darwin_config_defaults.mk  # macOS build config
+│   │   ├── win_x86_sdl2_config_defaults.mk  # Windows SDL2 simulator config
+│   │   ├── win_x86_cross_config_defaults.mk # Windows-to-device cross config
 │   │   ├── setup.ini           # SSH deployment config
 │   │   └── main/               # Main application source
 │   │       ├── SConstruct      # Component build script
 │   │       ├── src/
 │   │       │   └── main.cpp    # Program entry point
-│   │       ├── include/        # Public headers (battery, keyboard_input, etc.)
-│   │       ├── hal/            # Hardware abstraction layer
-│   │       │   ├── sdl/        # SDL2 platform implementation (PC debugging)
-│   │       │   └── linux/      # Linux platform implementation (device side)
 │   │       └── ui/             # UI code
-│   │           ├── ui.h / ui.c # UI initialization
-│   │           ├── screens/    # Screen definitions
-│   │           ├── components/ # Custom components (app pages, launcher, etc.)
-│   │           ├── widgets/    # Custom widgets (carousel component, etc.)
-│   │           ├── Animation/  # Animation effects
-│   │           ├── fonts/      # Font assets
-│   │           └── images/     # Image assets
+│   │           ├── ui.h / ui.cpp          # UI initialization
+│   │           ├── launch.cpp / launch.h  # App list and launch logic
+│   │           ├── app_registry.*         # Built-in app enable/disable registry
+│   │           ├── ui_launch_page.*       # Home carousel UI
+│   │           ├── launcher_ui_runtime.*  # LVGL runtime/home bootstrap
+│   │           ├── animation/             # Animation effects
+│   │           └── page_app/              # Built-in app pages
 │   ├── Calculator/             # Calculator
 │   ├── AppStore/               # App store
 │   └── HelloWorld/             # Hello World example
-├── ext_components/             # External components (Miniaudio, etc.)
-├── doc/                        # Documentation resources
+├── ext_components/             # External components (Miniaudio, RadioLib, etc.)
+├── docs/                       # Project documentation
+├── scripts/                    # Repository helper tools
 ├── README.md
-└── README_ZH.md
+├── README_ZH.md
+└── README_JA.md
 ```
 
 ---
@@ -68,7 +68,7 @@ launcher/
 ### APPLaunch Features
 
 - Application launcher UI with multi-app navigation (carousel page switching)
-- Built-in app pages: Stock, Music, Camera, LoRa, SSH, GPIO, MIDI, Console, Mesh, and more
+- Built-in app pages: CLI/ST terminal, Game, Setting, Compass, IP Panel, File, SSH, Mesh, Rec, Camera, LoRa, and Tank Battle, plus command/external entries such as Python, Store, and Math
 - LoRa communication (based on RadioLib SX1262)
 - Audio playback (based on Miniaudio)
 - Battery status monitoring and display
@@ -207,6 +207,47 @@ scons distclean
 scons -j8
 ```
 
+### Windows
+
+Windows builds use the same SCons entry point under `projects/APPLaunch`. Use an MSYS2 MinGW shell for the native SDL2 simulator build so that `gcc`, `g++`, `pkg-config`, SDL2, and FreeType are available in `PATH`.
+
+#### Install Dependencies (MSYS2 UCRT64 example)
+
+```bash
+pacman -S --needed \
+  mingw-w64-ucrt-x86_64-gcc \
+  mingw-w64-ucrt-x86_64-pkgconf \
+  mingw-w64-ucrt-x86_64-SDL2 \
+  mingw-w64-ucrt-x86_64-freetype \
+  mingw-w64-ucrt-x86_64-python-pip
+
+python -m pip install parse scons requests tqdm setuptools-rust paramiko scp
+```
+
+#### Build the APPLaunch SDL2 Simulator
+
+```bash
+cd projects/APPLaunch
+scons distclean
+export CONFIG_DEFAULT_FILE=win_x86_sdl2_config_defaults.mk
+scons -j8
+cd dist
+./M5CardputerZero-APPLaunch.exe
+```
+
+#### Cross-Compile APPLaunch for the Device
+
+Install the SysGCC Raspberry64 Windows AArch64 Linux cross toolchain from `https://sysprogs.com/getfile/2542/raspberry64-gcc14.2.0.exe`, and update `CONFIG_TOOLCHAIN_PATH` in `projects/APPLaunch/win_x86_cross_config_defaults.mk` if it is not installed at `D:\app\SysGCC\bin`.
+
+```bash
+cd projects/APPLaunch
+scons distclean
+export CONFIG_DEFAULT_FILE=win_x86_cross_config_defaults.mk
+scons -j8
+```
+
+The cross-build output is `dist/M5CardputerZero-APPLaunch` and runs on the CardputerZero device. The first cross-build may download the SDK sysroot package into `SDK/github_source/static_lib_v0.0.4`.
+
 ### Configuration Management Commands
 
 ```bash
@@ -232,14 +273,13 @@ This program is a desktop UI application running on the CardputerZero device. It
 
 ### Build
 
-Refer to the HelloWorld build instructions.
+For device builds, SDL2 simulator builds, and cross-compilation, use the platform-specific build commands above with `cd projects/APPLaunch`. APPLaunch provides its own configuration files, including `linux_x86_sdl2_config_defaults.mk`, `linux_x86_cross_cp0_config_defaults.mk`, `mac_cross_cp0_config_defaults.mk`, `win_x86_sdl2_config_defaults.mk`, and `win_x86_cross_config_defaults.mk`.
 
 ### Package
 
 ```bash
-# brew install dpkg # mac install dpkg tool.
-cd projects/APPLaunch/tools
-./llm_pack.py
+# Optional: install dpkg to use dpkg-deb; otherwise the Python builder is used.
+python3 scripts/debian_packager.py
 ```
 
 This command generates a DEB installation package. After transferring the package to the device with `scp`, install it with `sudo dpkg -i ./***.deb`.
@@ -248,23 +288,23 @@ This command generates a DEB installation package. After transferring the packag
 
 #### Auto Run
 
-After installing the DEB package with `dpkg`, the program is automatically started by the `APPLaunch.service` systemd service.
+After installing the DEB package with `dpkg`, the program is automatically started by the `APPLaunch.service` systemd user service.
 
 After installation, use `systemd` commands to view and control it:
 
 ```bash
-pi@pi:~ $ sudo systemctl status APPLaunch.service
+pi@pi:~ $ systemctl --user status APPLaunch.service
 ● APPLaunch.service - APPLaunch Service
-     Loaded: loaded (/usr/lib/systemd/system/APPLaunch.service; enabled; preset: enabled)
+     Loaded: loaded (/usr/lib/systemd/user/APPLaunch.service; enabled; preset: enabled)
      Active: active (running) since Mon 2026-06-08 15:58:19 CST; 23min ago
  Invocation: aa5c4e3ca94742deb2fe0dc67467e670
    Main PID: 664 (M5CardputerZero)
       Tasks: 7 (limit: 448)
         CPU: 1min 19.265s
-     CGroup: /system.slice/APPLaunch.service
+     CGroup: /user.slice/user-1000.slice/user@1000.service/app.slice/APPLaunch.service
              └─664 /usr/share/APPLaunch/bin/M5CardputerZero-APPLaunch
 
-Jun 08 15:58:19 pi systemd[1]: Started APPLaunch.service - APPLaunch Service.
+Jun 08 15:58:19 pi systemd[664]: Started APPLaunch.service - APPLaunch Service.
 ```
 
 #### Manual Run
@@ -296,10 +336,13 @@ The UI is designed and generated by SquareLine Studio 1.5.0, with a resolution o
 | Main content area | Application carousel pages (left/right page navigation) |
 | Global hints | ESC / Shift / SYM shortcut hint overlay |
 
-Built-in app pages include: Stock, Music, Camera, LoRa, SSH, GPIO, MIDI, Console, Mesh, Gallery, Email, File, Hack, Rec, Setup, Store, UnitEnv, IpPanel, LovyanGFX, HikePod, Tank Battle, and more.
+Built-in app pages include: CLI/ST terminal, Game, Setting, Compass, IP Panel, File, SSH, Mesh, Rec, Camera, LoRa, and Tank Battle. APPLaunch can also expose command or external-process entries such as Python, Store, and Math.
 
 ## Related Resources
 
+- [Japanese Project Guide](./docs/launcher-project-guide-ja.md)
+- [Japanese APPLaunch App Packaging Guide](./docs/APPLaunch-App-packaging-guide-ja.md)
+- [Japanese macOS Docker Build Guide](./docs/macos-docker-build-ja.md)
 - [M5Stack_Linux_Libs SDK](https://github.com/m5stack/M5Stack_Linux_Libs)
 - [LVGL Documentation](https://docs.lvgl.io/)
 - [SquareLine Studio](https://squareline.io/)