Skip to content

docs: expand GeneralUpdate.Tools Mobile packaging documentation#122

Merged
JusterZhu merged 2 commits into
mainfrom
docs/android-components-website
Jun 14, 2026
Merged

docs: expand GeneralUpdate.Tools Mobile packaging documentation#122
JusterZhu merged 2 commits into
mainfrom
docs/android-components-website

Conversation

@JusterZhu

Copy link
Copy Markdown
Collaborator

Summary

Expands the Mobile packaging section of the GeneralUpdate.Tools documentation across all three locale files (Chinese source, English i18n, zh-Hans i18n).

Changes

Technical depth added to "What the tool does internally"

  • Format detection internals: APK (root AndroidManifest.xml) vs AAB (base/manifest/AndroidManifest.xml) detection logic with failure fallback
  • AXML binary parsing detail: StringPool chunk (type 0x0001), Start Element chunks (type 0x0102), 20-byte attribute block layout, versionCode as typed integer (0x10/0x11)
  • Project build pipeline: MobileCsprojParser field extraction (single/multi-TFM, -android auto-select, ApplicationId/Version mapping), dotnet publish command, artifact auto-location
  • Upload form fields table: Full 9-field mapping with data sources and examples
  • Upload configuration: Server URL, endpoint (/Packet/Create), timeout, retry, auth modes (Basic/Bearer/API Key with DPAPI encryption)
  • Export Record Only: Manual URL fallback behavior documented

FAQ additions

5 mobile-specific entries covering: metadata extraction warnings, Build & Locate failures, build output not found, upload failures, and client update failures

zh-Hans i18n fix

The zh-Hans copy was completely missing the Mobile section — it only listed "6 modules" instead of 7. Added the full Mobile section including overview, inputs, workflow, internals, output, FAQ entries, and related docs links.

Files changed

  • website/docs/quickstart/GeneralUpdate.PacketTool.md (+55/-7)
  • website/i18n/en/docusaurus-plugin-content-docs/current/quickstart/GeneralUpdate.PacketTool.md (+55/-7)
  • website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/quickstart/GeneralUpdate.PacketTool.md (+156/-3)

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings June 14, 2026 04:08
@JusterZhu JusterZhu removed the request for review from Copilot June 14, 2026 04:08
- Add technical internals: format detection (APK vs AAB), AXML binary
  parsing (StringPool, StartElement chunks, versionCode extraction),
  project build pipeline (CsprojParser, dotnet publish, artifact locate)
- Add upload form field mapping table with data sources and examples
- Add upload service configuration details (endpoint, auth, DPAPI)
- Add 5 mobile-specific FAQ entries
- Add missing Mobile section to zh-Hans i18n copy
- Sync all changes to English i18n

Co-Authored-By: Claude <noreply@anthropic.com>
@JusterZhu JusterZhu force-pushed the docs/android-components-website branch from b021e99 to d82458e Compare June 14, 2026 04:09
- Avalonia Android: 快速入门 → 实战手册, Quickstart → Cookbook
- MAUI Android: 快速入门 → 实战手册, Quickstart → Cookbook

Aligns naming convention with Beginner cookbook.

Co-Authored-By: Claude <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 14, 2026 04:13
@JusterZhu JusterZhu merged commit 121215a into main Jun 14, 2026
3 checks passed
@JusterZhu JusterZhu deleted the docs/android-components-website branch June 14, 2026 04:16
@JusterZhu JusterZhu removed the request for review from Copilot June 14, 2026 04:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant