Skip to main content

Command Palette

Search for a command to run...

uni-app iOS File Management and itools Collaboration in Practice: A Complete Workflow for Multi-Tool Cooperation

Published
4 min read

In uni-app development, file management and debugging on the iOS platform have always been key challenges. Although Apple provides official methods such as Xcode and the Files App, for many developers and testers, these tools often come with usage barriers or functional limitations.

At this point, the third-party tool itools comes into view. With its simple and intuitive graphical interface, it has become the preferred choice for many developers and testers to manage iPhone files. However, itools alone cannot solve all problems, so we need to use it in combination with other tools to build a complete file management and performance debugging workflow.


1. Why uni-app iOS Development Requires File Management Tools

  • Plugin File Write Verification: uni-app plugins often write files via plus.io or native APIs, and it is necessary to check if they are saved in the correct directory.
  • Cache and Log Debugging: The iOS sandbox mechanism restricts access for ordinary users, requiring tools to export cache, configuration, and log files.
  • Version Compatibility Verification: The App sandbox directory may change across different versions, requiring comparison to confirm whether data is retained during the upgrade process.

2. Features and Applicable Scenarios of itools

Advantages

  • Intuitive graphical interface, suitable for non-professionals;
  • Supports file import and export, allowing quick viewing of the App's Documents, Caches, and other directories;
  • Facilitates easy App installation, uninstallation, and backup operations.

Limitations

  • Cannot directly access system-level logs and deep directories;
  • Does not support real-time performance monitoring (CPU/GPU/FPS);
  • Limited debugging dimensions compared to Xcode and KeyMob.

Therefore, itools is more suitable for:

  • Quickly checking whether files written by uni-app plugins are successful;
  • Verifying the existence of cache and configuration files;
  • Providing testers with intuitive file operation capabilities.

3. Best Combination of Tool Collaboration

ToolFunctional PositioningApplicable Phase
itoolsGraphical file management, App installation/uninstallationTesting/Verification
Xcode Devices & SimulatorsExport App Container, deep validation during debuggingDevelopment
KeyMobCross-platform access to sandbox, logs, crashes, and performance monitoringDevelopment/Testing/Operations
iMazingFile browsing and backup, suitable for quick verificationTesting
Crashlytics / FirebaseCollects online crash and performance dataOperations

4. Practical Case 1: uni-app Plugin File Write Verification

Background

A uni-app application integrated a file download plugin, and users reported that downloaded audio files could not be played.

Tool Collaboration Workflow

  1. uni-app Console
    • Checked plus.io write logs; the call was successful.
  2. itools
    • Opened the App sandbox and found the file was saved in the tmp/ directory.
  3. KeyMob
    • Exported the complete sandbox structure, compared and verified, confirming the issue was due to incorrect path usage.
  4. Fix Solution
    • Modified the plugin to write to Library/Caches/.
  5. Effect
    • File playback returned to normal, and the cache could be persistently saved.

5. Practical Case 2: Data Migration After App Version Upgrade

Background

A note-taking application based on uni-app lost historical data after user upgrades.

Tool Collaboration Workflow

  1. itools
    • Checked the old and new version directories and found that Documents/Notes/ was not retained.
  2. KeyMob
    • Exported and compared the old and new directories, confirming that data was not migrated.
  3. Xcode Instruments
    • Verified database read/write performance and investigated migration logic efficiency.
  4. Fix Solution
    • Added data migration steps in the upgrade logic.
  5. Effect
    • User note data was completely retained, and version compatibility issues were resolved.

6. Practical Case 3: Combining Performance and File Management

Background

A news-based uni-app application experienced lag on iOS.

Tool Collaboration Workflow

  1. itools
    • Checked the cache directory and found thousands of image caches were not cleaned.
  2. KeyMob
    • Monitored performance in real-time; GPU usage was too high, and FPS dropped to 20.
  3. Optimization Solution
    • Added a cache cleanup mechanism to avoid repeated GPU rendering.
  4. Verification
    • The lag issue was alleviated, and FPS recovered to above 55.

How to Efficiently Utilize itools and Multi-Tool Combinations

  • Development Phase: Use Xcode + KeyMob for in-depth analysis of file writes and performance bottlenecks;
  • Testing Phase: Use itools + iMazing for quick verification of correct file generation;
  • Operations Phase: Use Crashlytics + KeyMob to collect real user data and identify potential issues.

In this context, itools is positioned to simplify file access and lower the operational barrier, but it must be combined with professional tools like KeyMob and Xcode to form a complete uni-app iOS file management and performance debugging system.

More from this blog

scriptkit

8 posts