Development Directory
The Development Directory is the workspace for writing, testing, and organizing device-side script projects. A typical flow is to create or open a project here, then continue in the Text Editor to edit, run, debug, and generate artifacts.
If you only need to upload and batch-run existing scripts, start with Script Management.
Open the Development Directory
- Click
File Managerfrom the main action bar. - In the File Manager, switch to
Development Directoryfrom the directory buttons at the top. - From there, create a new project or right-click an existing project folder and open it.
The File Manager directories have different purposes:
Script Directory: scripts that can be selected, uploaded, and batch-run from the main screen.Resource Directory: images, temporary files, and reusable resources.Reports Directory: reports produced by batch authorization, schedules, and other operations.Development Directory: projects that are still being edited, tested, encrypted, or packaged.
If Development Directory is not visible, development project support is not enabled in the current deployment. You can still manage existing scripts from the Script Directory. To use development projects, use a runtime that supports this feature or ask the deployer to enable it.
Move the XXTStudio folder on macOS
The macOS desktop app stores XXTStudio files in ~/XXTStudio-Documents by default, also accessible through ~/Documents/XXTStudio.
If ~/Documents/XXTStudio is a regular directory, go to File Manager → Development and click Move Folder. After you confirm, XXTLanControl briefly goes offline and moves the entire folder, including projects, shared libraries, and certificates, to ~/XXTStudio-Documents. You can still access the files from the original location. If the destination already exists, clear that location before moving the folder.
Create a Project
In File Manager → Development Directory:
- Click
New Project. - Enter a project name.
- Choose the project type.
- Keep or disable
Open after create. - Click
Create.
Project names cannot contain / \ : * ? " < > |. Use names that are easy to recognize, such as English letters, numbers, dashes, or dots, for example com.example.demo.
Available project types:
Single-file Script (.xxt): For general script development.Script Package (.xpp): For maintaining script package projects.
If you are not sure which one to choose, start with Single-file Script (.xxt). Choose Script Package (.xpp) only when you specifically need to maintain an XXTouch script package.
Open a Project
In Development Directory, right-click a project folder and choose Open Project. The Text Editor opens with a project tree and editor area.
Common project tree actions:
- Click a text file to open it in the editor.
- Click an image file to preview it. From the preview, open the Color Picker when you need to sample colors.
- Right-click a file or folder name to create, rename, delete, copy paths, download, or reveal it in the File Manager.
- Drag files inside the project tree to organize the project.
- Right-click
main.jsonand chooseEdit Script UI Configurationto edit the script parameter form in the Script UI Editor.
After opening a project for the first time, usually edit the entry script first, then follow the Text Editor guide to select a development test device and run it once.