# Blockly-QuickApp

**Repository Path**: SandMo/Blockly-QuickApp

## Basic Information

- **Project Name**: Blockly-QuickApp
- **Description**: 基于快应用移植的Blockly框架，极度不完善
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-13
- **Last Updated**: 2026-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Blockly-QuickApp

基于 Blockly 的快应用可视化编程工具。

## 项目简介

Blockly-QuickApp 是一个将 Google Blockly 可视化编程框架与快应用(QuickApp)平台相结合的创新项目。该项目允许用户通过拖拽积木块的方式创建逻辑程序,并将其转换为可在快应用平台运行的代码。

## 主要功能

### 核心功能
- **可视化编程**: 通过拖拽积木块构建程序逻辑
- **多语言代码生成**: 支持生成 JavaScript、Python 等多种编程语言代码
- **块渲染引擎**: 自定义 Blockly 块渲染器,适配快应用界面
- **交互式编程**: 支持实时预览和调试

### 技术特性
- **积木块引擎**: 提供完整的 Blockly 集成和事件处理
- **自适应布局**: 积木块根据内容自动排列和测量
- **触摸交互**: 专为触屏设备优化的交互体验
- **日志系统**: 完整的日志记录和调试功能

## 项目结构

```
Blockly-QuickApp/
├── src/
│   ├── app.ux              # 应用入口文件
│   ├── blockly/            # Blockly 核心模块
│   │   ├── blockly.js      # Blockly 实例化
│   │   ├── index.ux        # Blockly 页面
│   │   └── view/           # 视图引擎
│   │       ├── engine.js   # 积木块渲染引擎
│   │       └── renderer.js # 自定义渲染器
│   ├── common/             # 公共模块
│   │   ├── css/            # 样式文件
│   │   │   └── common.css
│   │   └── log.js          # 日志工具
│   ├── home/               # 首页
│   ├── guide/              # 引导页
│   └── about/              # 关于页面
├── tools/                  # 开发工具集
│   ├── bundle.js           # 代码打包工具
│   ├── debug-block.js      # 积木块调试工具
│   ├── test-model.js       # 模型测试工具
│   ├── test-xml.js         # XML 测试工具
│   ├── webpack-run.js      # Webpack 运行配置
│   └── asar-index.js       # ASAR 归档工具
├── okii-docs/              # 快应用框架文档
├── sign/                   # 签名文件
│   ├── certificate.pem
│   └── private.pem
├── package.json
├── manifest.json
└── babel.config.js
```

## 开发环境

### 环境要求
- Node.js 8.0+
- 快应用开发工具
- npm 或 yarn 包管理器

### 安装依赖

```bash
npm install
```

### 运行项目

```bash
# 开发模式
npm run dev

# 构建项目
npm run build
```

## 使用说明

### 基础操作
1. **添加积木块**: 从工具栏拖拽所需的积木块到工作区
2. **组合积木**: 将积木块拼接在一起形成逻辑
3. **配置参数**: 点击积木块设置具体参数
4. **运行代码**: 点击运行按钮执行生成的代码

### 调试工具
项目提供了丰富的调试工具:
- `debug-block.js`: 积木块调试工具
- `debug-probe.js`: 探针调试工具
- `debug-sample.js`: 采样调试工具
- `viewtest-entry.js`: 视图测试工具

## 快应用文档

项目包含完整的快应用框架文档,位于 `okii-docs/` 目录,涵盖:

- 通用组件和样式
- 数据存储和文件操作
- 网络请求和传感器
- 页面路由和生命周期
- 性能优化指南

## 签名配置

项目包含用于应用发布的签名文件:
- `sign/certificate.pem`: 证书文件
- `sign/private.pem`: 私钥文件

## 许可协议

本项目遵循开源协议,具体许可信息请查看 LICENSE 文件。

## 贡献指南

欢迎贡献代码,请确保:
1. 代码符合 ESLint 规范
2. 提交前运行测试
3. 编写清晰的提交说明

## 联系方式

如有问题或建议,请通过 Gitee 项目页面提交 Issue。