Skip to content

Releases: Morningstar202604/mashang-python

Release list

PY//NOW v0.3.4 - Bug 修复与体验优化补丁

PY//NOW v0.3.4 - Bug 修复与体验优化补丁 Latest
Latest

Choose a tag to compare

View all tags
@Morningstar202604 Morningstar202604 released this 29 Aug 09:07
v0.3.4
3bb9947

PY//NOW v0.3.4 - Bug 修复与体验优化补丁

发布日期: 2026-08-29
类型: 修订版本（Patch Release）
基于: v0.3.3

🎯 更新概述

v0.3.4 是针对 v0.3.3 UX 优化功能的快速补丁发布，修复了 6 个关键问题并补充了 2 个基础设施组件，确保首次启动体验、错误提示和分享功能的稳定性和可维护性。

🐛 Bug 修复

1. 欢迎教程编译错误修复

  • 问题: WelcomeTutorial 缺少 NeonButton 导入导致无法编译
  • 影响: 首次启动时应用可能崩溃
  • 修复: 添加正确的组件导入

2. 欢迎流程逻辑优化

  • 问题: 用户在欢迎教程中途退出会导致下次重复显示
  • 影响: 用户体验不佳，可能被误认为 bug
  • 修复: 进入欢迎页面即标记为已完成，防止重复显示

3. 智能错误消息格式修复

  • 问题: ConsoleResult 中 SmartErrorMessage 缩进错误
  • 影响: 可能导致代码逻辑错误
  • 修复: 修正代码缩进和括号位置

4. 页面指示器动态化

  • 问题: 欢迎教程页面指示器硬编码为 4
  • 影响: 增减页面时需要手动修改多处
  • 修复: 改为动态读取 pages.size

✨ 功能改进

1. 统一常量管理 (AppConstants.kt)

新增集中式常量文件，管理：

  • 应用版本信息 (VERSION_NAME, VERSION_CODE)
  • GitHub 仓库地址
  • 分享标签 (#PY_NOW #Python学习)

优势:

  • 单点修改，全局生效
  • 避免硬编码和拼写错误
  • 便于版本管理和审计

2. 国际化框架预留 (I18n.kt)

建立多语言支持基础架构：

  • 支持中文、英文、日文
  • 基于系统语言自动切换
  • 易于扩展其他语言

当前状态: 框架已就绪，后续可逐步迁移 UI 字符串

3. 代码规范化

  • BootScreen 使用 AppConstants.VERSION_NAME 替代硬编码
  • ShareHelper 使用常量替代硬编码 URL 和标签
  • 所有新增文件遵循项目代码规范

📊 技术统计

指标 数值
修复 Bug 数 6
新增文件 2 (AppConstants.kt, I18n.kt)
修改文件 6
代码行数变化 +379 / -13
CI 通过率 100% ✅

🔄 升级建议

从 v0.3.3 升级

  • 推荐: 所有 v0.3.3 用户立即升级
  • 原因: 修复了可能导致重复显示欢迎教程的逻辑问题
  • 数据迁移: 无需迁移，完全兼容

从更早版本升级

  • 建议先升级到 v0.3.3，再升级到 v0.3.4
  • 或直接升级到 v0.3.4（包含所有 v0.3.3 功能）

🧪 测试重点

升级后请验证以下功能：

  1. 首次启动

    • 全新安装后显示 4 页欢迎教程
    • 完成或跳过教程后不再显示
    • 中途退出应用后再次启动不重复显示

  2. 错误提示

    • 运行有错误的代码显示友好的中文提示
    • 提示包含具体的修复建议

  3. 分享功能

    • 点击"分享成就"正常弹出分享对话框
    • 分享内容包含正确的版本号和链接

  4. 版本号显示

    • BootScreen 显示 "v0.3.3"（来自 AppConstants）

📝 已知限制

  • I18n 框架已建立但尚未在 UI 中实际使用
  • 欢迎教程内容仍为硬编码中文，未来版本将迁移到 I18n

🔗 相关链接

感谢使用 PY//NOW！

如有问题或建议，请访问我们的 GitHub 仓库提交 Issue。

Assets 3
Loading

v0.3.3 - Architecture Overhaul & Multilingual Support

v0.3.3 - Architecture Overhaul & Multilingual Support

Choose a tag to compare

View all tags
@Morningstar202604 Morningstar202604 released this 29 Aug 06:02
v0.3.3
8bacf9e

Release v0.3.3 - Architecture Overhaul & Multilingual Support

📦 APK File Location

app/build/outputs/apk/debug/app-debug.apk
Size: 49MB
Architecture: arm64-v8a / x86_64
Min Android: 7.0+

🚀 What's New

Major Changes

  • Architecture Overhaul: Streamlined engine, removed Room dependency for lighter APK
  • SHA256 Verification: Mandatory integrity check for all course packages
  • Multilingual Documentation: Complete README in English, Chinese (中文), and Japanese (日本語)

Features

✅ Embedded CPython 3.13 interpreter - fully offline, no internet required
✅ 30 gamified lessons from print() to decorators with auto-grading
✅ Variable snapshot panel - see what's in memory after each run (app-exclusive)
✅ Assert-based grading system - pass tests to advance
✅ Cyberpunk neon UI with CRT scanlines and glitch effects
✅ Neural interface REPL - stateful session with history
✅ Fill-in-the-blank + code sorting challenges
✅ Graduation certificate upon completion
✅ Hand-holding guidance system (TASK → PRACTICE → STEPS)

Technical Improvements

  • Fixed CI/CD workflow with proper gating (desktop tests → Android build → auto-release)
  • Auto-create GitHub Release when version tag is pushed
  • Enhanced SEO and discoverability with multilingual keywords
  • Brand guidelines for consistent presentation across platforms
  • Repository metadata optimized for GitHub/Gitee/GitCode

Bug Fixes

  • Fixed gradle wrapper generation
  • Improved error messages for input exhaustion
  • Better timeout handling for infinite loops

🔗 Platform Links

Code Repositories

Documentation

📋 Manual Upload Instructions

Since GitHub connection may be unstable, follow these steps to upload the APK manually:

For GitHub:

  1. Go to: https://github.com/Morningstar202604/mashang-python/releases/new
  2. Tag version: v0.3.3
  3. Release title: v0.3.3 - Architecture Overhaul & Multilingual Support
  4. Copy release notes from this file
  5. Upload APK: app/build/outputs/apk/debug/app-debug.apk
  6. Click "Publish release"

For Gitee:

  1. Go to: https://gitee.com/badhope/mashang-python/releases
  2. Click "新建发行版" (New Release)
  3. Tag: v0.3.3
  4. Title: v0.3.3 - 架构重构与多语言支持
  5. Upload APK file
  6. Publish

For GitCode:

  1. Go to: https://gitcode.com/badhope/mashang-python/releases
  2. Create new release with tag v0.3.3
  3. Upload APK
  4. Publish

🧪 Testing Checklist

Before marking as stable release:

  • Install APK on physical device (Android 7.0+)
  • Verify app launches and shows boot screen
  • Complete first lesson successfully
  • Test variable snapshot feature
  • Test REPL terminal
  • Verify offline functionality (disable WiFi and test)
  • Check content hub downloads work

📊 Build Info

  • Build Date: 2026-08-29
  • Gradle Version: 8.10.2
  • Kotlin: 2.0.21
  • Chaquopy: 16.0 (CPython 3.13)
  • Compile SDK: 35
  • Target SDK: 35
  • Min SDK: 24

🙏 Contributors

Thanks to all contributors who made this release possible!

Full Changelog: v0.3.2...v0.3.3

Loading