开发目录

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

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

进入开发目录

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

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

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

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

创建项目

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

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

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

可选项目类型：

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

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

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

打开项目

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

项目树常见操作：

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

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

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