# Tiecode-VSCode

**Repository Path**: scave/Tiecode-VSCode

## Basic Information

- **Project Name**: Tiecode-VSCode
- **Description**: 结绳VSCode插件
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-07
- **Last Updated**: 2026-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 结绳开发工具

这个 VSCode 插件为结绳开发提供 `.t` / `.tly` 语言识别、编译器 IDE Service 接入、工程模板和构建命令。

## 功能

- `.t` 和 `.tly` 语法高亮、语言配置和片段，默认使用 SweetLine WASM 提供接近 Mobile-IPE 的高亮规则。
- 通过结绳编译器 WASM IDE Service 提供补全、诊断、悬停、语义高亮、格式化、定义、引用、重命名、签名帮助和符号。
- `.tly` 支持布局诊断、格式化，以及基于安卓可视化组件扫描结果的组件名和属性名补全。
- 支持创建安卓工程、CXX 工程和网页工程，并复制对应基本库到工程 `绳包` 目录。
- 内置结绳编译器 WASM 和基本库，支持构建安卓、CXX 和网页工程；安卓工程会按调试包/正式包自动执行 Gradle 构建，CXX 工程会自动执行 CMake 配置和构建。
- 支持 F5 运行当前工程；安卓调试包会安装并启动生成的 launcher Activity，CXX 工程会启动生成的可执行文件，网页工程会打开生成页面。
- 支持通过 `mapping.bin` 将 Gradle/Javac 编译错误和 Android logcat 崩溃栈还原到结绳源文件行号。
- 提供结绳运行配置视图，可编辑工程类型、打包模式、SDK 版本、包名、图标、宏定义，并查看和修复 Java、Android SDK、adb、Gradle 环境。

## 工程结构

插件默认按 Mobile-IPE 的结绳工程习惯扫描：

- `源代码`
- `绳包/*/源代码`
- 插件内置基本库中的 `安卓基本库`、`CXX基本库`、`网页基本库`

创建新工程时，插件会从内置基本库复制对应的 `安卓基本库`、`CXX基本库` 或 `网页基本库` 到工程 `绳包` 目录，保持和 Mobile-IPE 工程结构一致。

结绳工程必须包含 Mobile-IPE/Rapid 风格的 `project.json`。插件优先通过 `typeId` 识别工程类型：`cn.tiecode.android`、`cn.tiecode.html`、`cn.tiecode.linux`，并会读取 `app_name`、`app_pkg`、`min_sdk`、`target_sdk`、`version_code`、`version_name`、`icon_path`、`source_version`、`project_version`、`macro_definitions` 等 IPE 字段。`tiecode.project.json` 仅作为已有工程的 VSCode 专用覆盖配置。

## 配置

插件内置结绳编译器 WASM 和基本库，不需要配置 `tiec` 可执行文件或基本库路径。编辑器行为可按需调整：

- `tiecode.highlight.engine`
- `tiecode.languageService.enabled`
- `tiecode.wasm.traceOutput`
- `tiecode.diagnostics.enabled`

`tiecode.highlight.engine` 默认为 `hybrid`，会优先使用 SweetLine WASM，高亮不可用时回退到编译器 IDE Service。也可以设置为 `sweetline`、`compiler` 或 `textmate`。