Studio Project Management
Use the Studio Web "Projects" page to create projects, run the local development runtime, import and export project packages, manage plugins, upload projects to Watchdog, and download projects from Watchdog.
| Area or action | Description |
|---|---|
| Sort | Sort by update time, create time, or name. |
| View switcher | Switch between list and card view on desktop. |
| New project | Open the project panel and create a local project. |
| Stop runtime | Stop the currently running development runtime. |
| Import project | Import a ZIP project package. |
| Download from gateway | Download a project from a configured Watchdog service. |
| Gateway version | View current runtime version, latest version, and update status. |
| Project actions | Start/stop runtime, edit, export, upload, manage plugins, or delete a project. |
Project Lifecycle
| Phase | Studio action | Notes |
|---|---|---|
| Create | New project or import ZIP | Use clear names and descriptions so uploads and backups are easy to identify. |
| Debug locally | Start runtime and open GatewayRuntime Web | Configure channels, devices, variables, scripts, and forwarding in GatewayRuntime Web. |
| Check plugins | Plugin management | Resolve missing plugins before publishing. |
| Publish | Upload to Watchdog | Select target Watchdog, publish type, runtime identifier, runtime update option, and plugins. |
| Retrieve | Download from gateway | Pull a field project back into Studio for maintenance or troubleshooting. |
| Archive | Export ZIP | Keep a versioned project package for migration or rollback. |
Create or Edit a Project
| Field | Description |
|---|---|
| Project name | Required, 2-50 characters. Include site or line information when possible. |
| Project description | Optional maintenance notes, purpose, version information, or field differences. |
| Save | Create or update the project. |
| Cancel | Close the panel without saving. |
Run the Development Runtime
Click a project or use the main project action button. Studio starts the development runtime and opens GatewayRuntime Web.
| State | UI behavior | Recommendation |
|---|---|---|
| Not running | The action button starts the runtime. | Wait until the runtime starts and the GatewayRuntime Web page opens. |
| Running | The project is marked as running. | Opening the project goes directly to GatewayRuntime Web. |
| Switching projects | Starting another project changes the active runtime. | Save any work in GatewayRuntime Web before switching. |
Import and Export
| Operation | Description |
|---|---|
| Import ZIP | Select or drag a ZIP package. An optional import name can override the original project name. |
| Export ZIP | Use the project action menu. The browser downloads ${projectName}.zip; there is no separate export dialog. |
Plugin Management
| Field or action | Description |
|---|---|
| Total/enabled count | Shows total plugins and enabled plugins. |
| Selection | Select multiple plugins for batch enable or disable. |
| Package name | Plugin package identifier. |
| Version | Plugin version. |
| Status | Enabled, disabled, missing, or core-protected. |
| Enable/remove | Enable optional plugins or disable enabled plugins. Core plugins cannot be removed. |
Resolve any "missing" plugin before uploading the project.
Upload to Watchdog
| Field | Description |
|---|---|
| Project name | Current project, read-only. |
| Target gateway | A Watchdog service saved on the Studio Watchdog page. |
| Publish type | Normal publish or AOT publish. |
| Target environment | Runtime identifier for the target OS/architecture. |
| Update runtime | Upload runtime program files together with the project. |
| Force restore | Restore/apply the uploaded project on the target Watchdog. |
| Select plugins | Choose plugins to include with the upload. |
Before publishing, test the Watchdog connection, create a backup on the target, and verify plugin status.
Download from Gateway
| Field | Description |
|---|---|
| Source gateway | Watchdog service to read projects from. |
| Project list | Project package on the selected Watchdog. |
| Overwrite existing project | Allow replacing a local project with the same name. |
After downloading, open the project and check channel, device, variable, and plugin status.
FAQ
| Symptom | Suggested action |
|---|---|
| No target gateway appears | Add and test a Watchdog service on the Studio Watchdog page. |
| Upload fails | Check Watchdog status, plugin availability, publish type, target environment, and runtime update options. |
| Download list is empty | Check the source Watchdog connection and whether Watchdog has project packages. |
| AOT publish fails | Confirm runtime identifier, runtime files, and plugin AOT compatibility. |