跳到主要内容

# 开发目录

开发目录是编写、测试和整理设备端脚本项目的工作区。通常先在这里创建或打开项目，再进入 文本编辑器 编辑、运行、调试和生成产物。

如果只是把已有脚本上传后批量运行，可以先阅读 脚本管理。

## 进入开发目录​

1. 在主界面顶部动作条点击 `文件管理`。
2. 在文件管理器顶部的目录按钮中切换到 `开发目录`。
3. 进入后，可以新建项目，也可以右键已有项目文件夹打开项目。

文件管理器里的几个目录用途不同：

- `脚本目录`：存放可直接在主界面选择、上传和批量运行的脚本。
- `资源目录`：存放图片、临时文件和其它可复用资源。
- `报告目录`：存放批量授权、计划任务等操作产生的报告。
- `开发目录`：存放仍在编辑、测试、加密或打包的开发项目。

如果顶部没有看到 `开发目录` 按钮，说明当前部署没有开启开发项目功能。仍然可以使用 `脚本目录` 管理已有脚本；需要开发项目功能时，请使用支持该能力的桌面运行方式，或联系部署者开启。

## 创建项目​

在 `文件管理 → 开发目录` 中创建项目：

1. 点击 `新建项目`。
2. 输入项目名称。
3. 选择项目类型。
4. 保留或取消 `创建后立即打开`。
5. 点击 `创建`。

项目名称不能包含 `/ \ : * ? " < > |`。建议使用容易识别的英文、数字、短横线或点号，例如 `com.example.demo`。

可选项目类型：

- `单文件脚本（.xxt）`：适合常规脚本开发。创建后会默认打开入口脚本，并展开常用脚本目录。
- `脚本包（.xpp）`：适合维护脚本包项目。创建后会默认打开根目录下的入口脚本。

不知道选哪个时，优先选择 `单文件脚本（.xxt）`；只有明确要维护 XXTouch 脚本包时，再选择 `脚本包（.xpp）`。

默认勾选 `创建后立即打开`。保留勾选时，项目创建完成后会自动打开文本编辑器；取消勾选时，只会在开发目录中创建项目文件夹，稍后可以手动打开。

## 打开项目​

在 `开发目录` 中右键项目文件夹，选择 `打开项目`。文本编辑器会显示项目树和编辑区。

项目树常见操作：

- 点击文本文件，在编辑区打开。
- 点击图片文件，预览图片；需要取色时，可以从预览中打开取色器。
- 在文件或文件夹名称上点右键，执行新建、重命名、删除、复制路径、下载、在文件管理器中查看等操作。
- 在项目树内拖动文件到目标文件夹，整理项目结构。
- 右键 `main.json` 并选择 `编辑脚本 UI 配置`，可以进入脚本界面编辑器维护脚本运行参数表单。

同一时间打开另一个项目时，如果当前项目有未保存内容，文本编辑器会先询问是否关闭，避免误丢修改。

第一次打开项目后，通常先编辑入口脚本，再按 文本编辑器 中的步骤设置开发测试设备并运行一次。