# Introduction to Developer Tools
Developer Tools, fully named FinClip Integrated Development Environment, with the Chinese name "FinClip Mini-Program Developer Tools", is a mini-program developer tool launched by FinClip for mini-program developers.
It helps mini-program developers complete basic functions such as mini-program development, debugging, preview, and upload. The Developer Tools can run on multiple platforms including Windows and Mac, thereby assisting developers in developing mini-programs more efficiently.
Obtain Developer Tools
You can click Left Directory - Update Log or click here (opens new window) to obtain the latest version of Developer Tools.
This article will introduce the different components of Developer Tools to help you quickly understand and familiarize yourself with them, thereby enabling you to complete mini-program development work more effectively.
# 1. Developer Tools Interface and Functions
# 1.1 Main Interface of Developer Tools
After you install and open Developer Tools, you will see the interface corresponding to the image above, where:
- Version Prompt and Check: You can view the current FinClip Studio version in use; clicking allows version updates.
- Mini-Program Code Compatibility Check Tool: Performs compatibility checks on existing mini-program code packages to understand if the features in the current mini-program are available in FinClip.
- Developer Documentation: Quickly opens FinClip Developer Documentation.
- User Login: Use SMS verification code, QR code scanning, or account/password login for Developer Tools. You can register an account here (opens new window).
- Open Project: Opens an existing mini-program project.
- Manage Projects: Manages and deletes existing mini-program projects in Developer Tools.
- New Project: Creates a new mini-program project.
# 1.2 Logging into FinClip
When using the FinClip.com environment, you can log into your FinClip account using account/password (marked as 1), SMS verification code (marked as 2), or by scanning a QR code with the FinClip App on your mobile phone (marked as 3).
If you are using a private deployment version (including certified and compliant App Market) or community edition, please click the server switch button marked as 4 in the image above. In the newly opened popup, select the corresponding server environment according to your needs, and then complete the user login operation.

# 1.3 Creating a New Project
When you click the "New" button, the "Create Mini-Program" page will open. You need to confirm the following:
- Project Name: The name of the mini-program to be created.
- Project Directory: The file directory where the mini-program source code is located (defaults to the current user directory).
- Project Type: Mini-Program or Mini-Program Plugin (cannot be changed once selected).
- Project Template: Choose from "Blank Template", "Mini-Program Example Template", or "Webview" template.
- App ID: You need to create a mini-program in FinClip to obtain an AppID (required only for upload).
# 1.4 Main Interface
As shown above, the main interface of Developer Tools consists of:
- Toolbar: Displays/closes different panels, opens the documentation center, performs compilation, or other operations.
- Simulator: Simulates and previews the usage effect of the mini-program. You can also set different device models and display ratios to view and adjust the preview effect.
- File Manager: Views directory tree structure and content, adds files or folders. Clicking any file displays its specific content on the right. Together with the Content Editor, it is referred to as the "Editor".
- Content Editor: Modifies code content. Together with the File Manager, it is referred to as the "Editor".
- Debugger: Debugs mini-program code, views errors, or other prompts.
# 1.5 Window Menu and Shortcuts
To help developers use Developer Tools efficiently for mini-program development, you can also perform related operations through the window menu or shortcuts:
- New Project: Shift+Command (Ctrl) + N
- Open Project: No shortcut available
- Close Current Project: Shift+Command (Ctrl) + W
- Close Current File: Command (Ctrl) + W
- Save File: Command (Ctrl) + S
- Save All: Option (Alt) + Command (Ctrl) + W
- Undo: Command (Ctrl) + Z
- Cut: Command (Ctrl) + X
- Copy: Command (Ctrl) + C
- Paste: Command (Ctrl) + V
- Find: Command Ctrl) + F
- Global Search: Shift+ Command (Ctrl) + F
- Replace: Command (Ctrl) + H
- Select All: Command (Ctrl) + A
- Copy Line Up: Option (Alt) + Shift) + ↑
- Copy Line Down: Option (Alt) + Shift) + ↓
- Move Line Up: Option (Alt) + ↑
- Move Line Down: Option (Alt) + ↓
- Back: Option (Alt) + ←
- Forward: Option (Alt) + →
- Go to File: Command (Ctrl) + P
- Go to Line: Command (Ctrl) + G
- Show/Hide Simulator: Shift+Command (Ctrl) + D
- Show/Hide Editor: Shift+Command (Ctrl) + E
- Show/Hide Debugger: Shift+Command (Ctrl) + I
- Compile: Command (Ctrl) + B
- Preview: No shortcut available
- Upload: No shortcut available
- Delete App Data: No shortcut available
- Build npm: No shortcut available
# 1.6 Toolbar

- Simulator, Editor, Debugger: Toggles the display of the corresponding panels below.
- Documentation: Jumps to and opens the "Developer Tools" operation guide documentation.
- Switch Compilation Mode: Configures the corresponding compilation mode (e.g., configuring startup page, parameters), and performs compilation and preview operations.
- Real Device Debugging: Allows developers to debug the mini-program on a real device. All operation information will be transmitted back to Developer Tools.
- Clear Cache: Simulates clearing the cache for mini-program debugging (supports three modes: Clear File Cache / Clear Compilation Cache / Clear All).
- Upload: Uploads the current mini-program code package to the version directory of the corresponding mini-program.
- Details: Views the mini-program Base Library version, configures UA information, etc.
- Export: Exports the current mini-program into a .zip format code package or Offline Package.
- Generate App: Converts the mini-program into a corresponding App project or installation file.
# 1.7 Simulator
The simulator reflects the real logic performance of FinClip Mini-Programs in the client. Most APIs can display the correct status in the simulator. You can switch device models and resolutions using the buttons in the upper left corner to debug adaptation issues of the mini-program on devices of different sizes.
Additionally, you can use the operation buttons in the upper right corner to simulate "Background Switching / Simulate Location / Shake / Scan Code" operations on the mini-program, thereby simulating and testing related business logic within the mini-program.

The page path and parameter information at the bottom help you quickly locate the page position and related opening parameters, facilitating quicker issue identification during testing and debugging.
# 1.8 File Manager
The File Manager helps you view files related to the mini-program. Under the "Mini-Program Code Root Directory", you can see five mini-program application-level files:
- app.ftss: Mini-program global public Style file
- app.js: Mini-program logic file
- app.json: Mini-program configuration file
- fide.project.config.json: Project configuration file
- sitemap.json: Mini-program index sitemap
Additionally, there are two folders parallel to these five files: "pages" and "utils". The "pages" folder is used to store the specific directories for each page within the mini-program.
As shown above, you will see two directories under the "pages" directory: "index" and "logs", which refer to the corresponding files for the "index" and "logs" pages respectively. Each page consists of the following four files (taking the index page as an example; note that all file names within each page directory must be identical):
- index.ftss: Page Style file
- index.fxml: Page structure file
- index.js: Page logic file
- index.json: Page configuration file
# 1.9 Content Editor
The Editor module allows you to write code for the current project and perform basic operations such as adding, deleting, and renaming files.
- File Support: The tool currently provides editing for 4 types of files: fxml, ftss, js, json, as well as file preview.
# 1.10 Debugger
The Debugger includes the following functional modules:
- Quick Selection: Quickly locates the ftml code corresponding to components on the page.
- View: Views the real page structure and the ftss attributes corresponding to the structure. You can also modify the corresponding ftss attributes and see the changes in real-time in the simulator.
- Logs: Developers can debug code here.
- Network: Observes and displays request and socket request statuses.
- Storage: Displays and modifies the data attributes of the current page.
- Compilation Logs: Observes and displays the compilation process and error information of the FinClip Mini-Program.
- Api Mock: Modifies the callback content of test APIs.
# 2. Developer Tools Operation Feedback
# 2.1 Version Update
You can click the "Version Number" on the left side of the Developer Tools main interface or go to "Help -> Check for Updates" at the top to obtain the latest version of Developer Tools.
# 2.2 Upload Logs
If you encounter abnormal situations or other problems while using Developer Tools, please contact FinClip staff and then click "Help -> Upload Logs" at the top. Our staff will promptly assist you in resolving the related issues.