Built-in mount is FolkPatch's native mount system, which can complete file mounting without relying on external meta modules, providing a simpler and more efficient user experience.

Working Principle

Core mechanism of built-in mount system:

1. Core Service: FolkPatch core service directly handles mount operations
2. Mount Engine: Built-in optimized mount engine, reducing intermediate links
3. Real-time Processing: Mount operations are directly controlled by the application, responding faster
4. Independent Operation: Does not rely on external meta modules, simpler architecture

Technical Architecture

FolkPatch Built-in Mount System Architecture:

┌─────────────────────────────────────┐
│          FolkPatch App Layer        │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│         Built-in Mount Engine       │
│  ┌─────────────┐  ┌──────────────┐  │
│  │ Mount Manager│  │File Map Svc  │  │
│  └─────────────┘  └──────────────┘  │
└──────────────┬──────────────────────┘
               │
┌──────────────▼──────────────────────┐
│        System Mount Interface       │
│  • /system  • /vendor  • /product   │
└─────────────────────────────────────┘

Features

Core Advantages

• Strong Independence: Completely built into FolkPatch, no external dependencies
• Performance Optimization: Streamlined mount process, faster response speed
• Simple Configuration: Manage directly within the app, no extra operations required
• Clear Architecture: Simple system architecture, easy to understand and maintain
• Low Resource Usage: Occupies less storage space compared to meta module schemes

Built-in Mount vs Meta Module Mount

Comparison Item	Built-in Mount	Meta Module Mount
Startup Speed	⭐⭐⭐⭐⭐ Faster	⭐⭐⭐ Requires loading meta module
Config Difficulty	⭐⭐ Simple	⭐⭐⭐ Requires installing meta module
System Overhead	⭐⭐⭐⭐⭐ Very Low	⭐⭐⭐ Medium
Compatibility	⭐⭐⭐ Supports most scenarios	⭐⭐⭐⭐⭐ Widely compatible
Function Completeness	⭐⭐⭐ Basic functions	⭐⭐⭐⭐⭐ Complete functions
Independence	⭐⭐⭐⭐⭐ Completely independent	⭐⭐ Relies on meta module

Configuration Method

Enable Built-in Mount System

Step Description:

1. Open FolkPatch App

   • Launch FolkPatch from app list
   • Ensure app has Root permission

2. Enter Settings Page

   • Click "Settings" icon in bottom navigation bar
   • Or enter using sidebar menu

3. Find Mount Settings

   • Enter "General" category
   • Select "Folk Mount API" option

4. Enable Mount System

   • Find "Enable Mount System" switch
   • Toggle switch to "On" state
   • Restart device, ensure no meta modules are installed

5. Restart Device

   • Save current work
   • Click "Restart Now" button
   • Wait for system startup to complete

Verify Mount System

Verify if built-in mount is effective after restart:

Method 1: Check Setting Status

1. Open FolkPatch Settings
2. Enter "Advanced Settings"
3. Confirm "Enable Mount System" shows as On

Method 2: Install Test Module

1. Download a simple system modification module
2. Install in FolkPatch module page
3. Check if modification is effective after restart

Method 3: Check Logs

# Check mount log
cat /data/adb/folkpatch/logs/mount.log | grep "Built-in Mount"

# View system mount points
mount | grep folkpatch

Usage Scenes

Recommended Situations

✅ Daily Users

• No need for complex mount configurations
• Pursue concise user experience
• Mainly use basic function modules

✅ Performance Sensitive Devices

• Lower device configuration
• Pursue faster startup speed
• Wish to reduce system overhead

✅ Simplified Management

• Dislike installing extra meta modules
• Wish to manage all functions uniformly
• Reduce system dependencies

✅ Quick Deployment

• Need to quickly build environment
• Don't want to learn complex configurations
• Wish for out-of-the-box experience

Not Applicable Situations

❌ Complex Mount Needs

• Need to use multiple advanced mount modules
• Rely on specific mount mechanisms (like Overlayfs)
• Need cross-module file interaction

❌ Compatibility Requirements

• Need to cooperate with other Root toolchains
• Use special format modules
• Rely on functions provided by meta modules

Module Management

Supported Module Types

Built-in mount system supports the following types of modules:

Module Type	Support Level	Description
System Modification Module	✅ Fully Supported	Modules modifying /system directory
Property Modification Module	✅ Fully Supported	Modules modifying system properties
Service Injection Module	✅ Supported	Modules injecting system services
Overlay Module	⚠️ Partially Supported	Modules relying on Overlayfs may not be fully compatible
Custom Script Module	✅ Supported	Modules containing custom scripts

Module Installation Flow

1. Prepare Module File

   • Download or create module ZIP file
   • Ensure module format is correct

2. Install Module

   Steps:
   1. Open FolkPatch App
   2. Enter "Module" page
   3. Click "+" button in bottom right corner
   4. Select module file
   5. Wait for installation to complete

3. Manage Module

   • Enable/Disable module
   • View module details
   • Uninstall unwanted modules

Mount Control

Built-in mount system provides refined mount control:

Skip Specific Directory:

Create skip_mount file in module directory to skip mounting:

/data/adb/modules/module_name/
├── module.prop
├── system/
│   ├── app/
│   └── priv-app/
└── skip_mount  # ← Create this file, system directory will not be mounted

Custom Mount Path:

Specify mount path via module configuration file:

# module.prop
id=my_module
name=My Module
version=v1.0
mount_point=/system/etc/custom  # Specify mount point

Performance Optimization

Startup Speed Comparison

Test Data (Startup time of different mount methods):

Mount Method	Avg Startup Time	Performance Rating
Built-in Mount	45-60 sec	⭐⭐⭐⭐⭐
Meta Module Mount	60-90 sec	⭐⭐⭐
Multi Meta Module Mount	90-120 sec	⭐⭐

Performance Hint

• Built-in mount reduces overhead of loading meta modules
• Mount operations are directly controlled by FolkPatch, more efficient
• Recommended to choose built-in mount for daily use

Resource Usage

Storage Space Comparison:

Component	Built-in Mount	Meta Module Mount
Meta Module Itself	Not Needed	Approx 5-10 MB
Extra Files	None	May have dependencies
Cache Data	Approx 1-2 MB	Approx 2-3 MB
Total	Approx 1-2 MB	Approx 7-13 MB

FAQ

Q: Relationship between Built-in Mount and "Enable Mount System" setting?

A: Both are the same function:

• "Enable Mount System" switch controls the enabled status of built-in mount
• After enabling, FolkPatch uses built-in mount engine
• After disabling, need to rely on external meta modules (or not use mount)

Q: What to note when switching from meta module to built-in mount?

A: Switching steps:

1. Backup Data

   • Export important modules
   • Save configuration files
   • Record current module list

2. Uninstall Meta Module

   # Operate in FolkPatch
   1. Enter "Module" page
   2. Find FolkMeta meta module
   3. Click "Uninstall"
   4. Restart device

3. Enable Built-in Mount

   • Enter Settings -> Advanced Settings
   • Turn on "Enable Mount System"
   • Restart device again

4. Reinstall Modules

   • Reinstall needed modules using FolkPatch
   • Verify if module functions are normal

Q: Does built-in mount support all modules?

A: Supports most common modules:

• ✅ Fully Supported: Basic system modification, property modification, script injection
• ✅ Basically Supported: Most Magic Mount format modules
• ⚠️ Partially Supported: Modules relying on special mount mechanisms
• ❌ Not Supported: Must rely on specific functions of meta modules

Compatibility Check:

# Check mount methods supported by module
cat /data/adb/modules/module_name/module.prop | grep mount

Q: How to troubleshoot built-in mount failure?

A: Troubleshooting steps:

1. Check Logs

   # FolkPatch Log
   cat /data/adb/folkpatch/logs/folkpatch.log
   
   # System Log
   logcat -d | grep -i mount

2. Common Errors & Solutions:

   Error Info	Cause	Solution
   Insufficient Mount Permission	Root permission issue	Re-acquire Root permission
   Mount Point Conflict	Other mounts exist	Uninstall conflicting module
   Insufficient Storage Space	Space insufficient	Clean storage space
   Module Format Error	Module damaged	Re-download module

3. Recovery Scheme

   • Disable problem module
   • Temporarily switch to Lite mode
   • Reinstall FolkPatch

Best Practices

1. Prioritize Built-in Mount

   • For daily use, recommended to enable built-in mount
   • Enjoy faster startup speed and simpler architecture

2. Choose Mount Method Reasonably

   • Basic Needs: Use built-in mount
   • Complex Needs: Consider meta module mount
   • Minimalist Needs: Use Lite mode

3. Regular Maintenance

   • Clean up unused modules
   • Check mount status
   • Update FolkPatch to latest version

4. Backup Important Data

   • Backup before switching mount method
   • Save important module configurations
   • Record system modification history

Related Links

• Meta Module Mount - Understand external meta module mount scheme
• Lite Mode - Lightweight running mode
• Advanced Settings - Mount system switch location

Copyright

Copyright Ownership:FolkPatch Team

License under:Attribution 4.0 International (CC-BY-4.0)

Edit this page

Contributors: Matsuzaka Yuki

Previous pageMeta-Module Mount

Next pageLite Mode