# TiecodeCompiler

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

## Basic Information

- **Project Name**: TiecodeCompiler
- **Description**: 结绳编译器共享仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 20
- **Forks**: 3
- **Created**: 2023-11-22
- **Last Updated**: 2025-05-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 结绳编译器
## 介绍
结绳编译器是结绳中文编程所使用的编译器合集，其支持将结绳中文代码编译为Android、
Linux、WebPage、Windows、iOS等主流平台应用，目前还在完善中。

## 使用方法
### 命令行使用
##### 程序内调用
```java
import com.tiecode.compiler.Main;
{
    String args[] = {参数...};
    Main.main(args);
}
```
##### 参数介绍
```shell
参数: <需要编译的文件集...> [选项 [参数]], 目前支持的选项如下:
-o <输出路径>               指定编译输出文件夹路径
-dir <源代码目录路径>        传入源代码目录路径,该选项会递归扫描目录下所有源代码文件
-zip <源代码压缩包路径>      传入源代码压缩包路径,该选项会将压缩包内所有源代码文件一并编译
-p <目标平台>               指定编译输出的目标平台(不指定默认为Android), 目前支持的平台如下: 
    android : 指定输出到Android平台
    linux   : 指定输出到Linux平台
    windows : 指定输出到Windows平台
    webpage : 指定输出到Web平台
-ns <命名空间>              指定编译输出程序的命名空间(程序包名)
-l <日志等级>               指定日志输出等级, 目前支持以下等级:
    0 : 输出所有日志信息
    1 : 仅输出警告和错误日志
    2 : 仅输出错误日志
-g                         指定为调试模式
-gt <输出路径>              指定调试工具输出路径
-gp <调试平台Bundle ID>     指定调试程序平台的命名空间(程序包名)
-map <输出路径>             指定行号表输出路径
-c  <配置名称=配置值>       指定附加配置项, 目前支持的配置项如下: 
    ANDROID_ABI : 指定Android平台使用Native构建时输出的架构名称, 如all/arm64-v8a/x86等
--hard                     开启硬编译模式, 即程序所使用到的第三方库和资源全部拷贝到输出目录
--optimize                 开启编译优化, 会将无用语句去除并精简代码
--redirect-out <日志路径>   指定重定向的日志输出文件路径
--redirect-err <日志路径>   指定重定向的错误日志输出文件路径
--help                     显示本帮助内容
```

示例使用(编译Android平台应用):
```java
import com.tiecode.compiler.Main;

class MyCompiler {
    static String PATH = "/sdcard/Tiecode/Projects/MyApp";

    public void compile() {
        String[] commands = {
                PATH + "/源代码/初始代码.t",
                PATH + "/源代码/工具.t",
                "-dir",
                PATH + "/绳包",
                "-o",
                PATH + "/output",
                "-map",
                PATH + "/output/line.map",
                "-ns",
                "com.test.app",
                "-p",
                "ANDROID"
        };
        Main.main(commands);
    }
}
```
##### 配置环境变量后使用
下载 Executable 目录下 tiec.exe 文件，将其所在目录加入环境变量 Path<br>
用法: 
```shell
tiec 参数...
```
示例使用(编译Windows应用):
```shell
tiec D:\Test\Startup.t D:\Test\Tool.t -dir D:\Test\绳包\Windows基本库 -o D:\Test\output -map D:\Test\output\line.map -ns tiecode -p WINDOWS
```

### 行号还原和标识符名称还原
具体参见: [行号和标识符名称还原](ReTrace.md)

### API调用
具体参见: [编译器API](API.md)

### 实现代码提示、代码检查、高亮等功能
具体参见: [使用代码服务](CodeService.md)

### 示例工程
关于代码提示、代码检查、转到定义等代码功能也可下载Sample目录下的示例工程参考