feat: support cross-platform host builds

Author: YinMo19

.github/workflows/ci.yml

@@ -9,8 +9,18 @@ permissions:
 
 jobs:
   build:
-    name: Build / Lint (macOS aarch64)
-    runs-on: macos-14
+    name: Build / Lint (${{ matrix.label }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-14
+            label: macOS arm64
+          - os: ubuntu-latest
+            label: Linux x86_64
+          - os: windows-latest
+            label: Windows x86_64
 
     steps:
       - name: Checkout
@@ -21,20 +31,17 @@ jobs:
         with:
           components: rustfmt, clippy
 
-      - name: Add target
-        run: rustup target add aarch64-apple-darwin
-
       - name: Cache cargo artifacts
         uses: Swatinem/rust-cache@v2
 
       - name: Check formatting
         run: cargo fmt --all -- --check
 
       - name: Check compilation
-        run: cargo check --all-targets --target aarch64-apple-darwin
+        run: cargo check --all-targets
 
       - name: Run clippy
-        run: cargo clippy --all-targets --target aarch64-apple-darwin -- -D warnings
+        run: cargo clippy --all-targets -- -D warnings
 
       - name: Run tests
-        run: cargo test --target aarch64-apple-darwin
+        run: cargo test

.github/workflows/release.yml

@@ -10,8 +10,27 @@ permissions:
 
 jobs:
   build:
-    name: Build release asset (macOS aarch64)
-    runs-on: macos-14
+    name: Build release asset (${{ matrix.label }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-14
+            label: macOS arm64
+            artifact_name: insert-dylib-macos-aarch64
+            binary_name: insert-dylib
+            archive_glob: dist/*.tar.gz
+          - os: ubuntu-latest
+            label: Linux x86_64
+            artifact_name: insert-dylib-linux-x86_64
+            binary_name: insert-dylib
+            archive_glob: dist/*.tar.gz
+          - os: windows-latest
+            label: Windows x86_64
+            artifact_name: insert-dylib-windows-x86_64
+            binary_name: insert-dylib.exe
+            archive_glob: dist/*.zip
 
     steps:
       - name: Checkout
@@ -20,30 +39,39 @@ jobs:
       - name: Install Rust toolchain
         uses: dtolnay/rust-toolchain@stable
 
-      - name: Add target
-        run: rustup target add aarch64-apple-darwin
-
       - name: Cache cargo artifacts
         uses: Swatinem/rust-cache@v2
 
       - name: Build release binary
-        run: cargo build --release --target aarch64-apple-darwin
+        run: cargo build --release
 
       - name: Package archive
+        if: runner.os != 'Windows'
         shell: bash
         run: |
           set -euo pipefail
-          package_dir="insert-dylib-macos-aarch64"
+          package_dir="${{ matrix.artifact_name }}"
           mkdir -p dist "$package_dir"
-          cp "target/aarch64-apple-darwin/release/insert-dylib" "$package_dir/"
+          cp "target/release/${{ matrix.binary_name }}" "$package_dir/"
           cp README.md README.cn.md LICENSE "$package_dir/"
           tar -czf "dist/${package_dir}.tar.gz" "$package_dir"
 
+      - name: Package archive
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          $packageDir = "${{ matrix.artifact_name }}"
+          New-Item -ItemType Directory -Force -Path "dist" | Out-Null
+          New-Item -ItemType Directory -Force -Path $packageDir | Out-Null
+          Copy-Item "target/release/${{ matrix.binary_name }}" $packageDir
+          Copy-Item README.md, README.cn.md, LICENSE $packageDir
+          Compress-Archive -Path "$packageDir/*" -DestinationPath "dist/$packageDir.zip" -Force
+
       - name: Upload workflow artifact
         uses: actions/upload-artifact@v4
         with:
-          name: insert-dylib-macos-aarch64
-          path: dist/*.tar.gz
+          name: ${{ matrix.artifact_name }}
+          path: ${{ matrix.archive_glob }}
 
   publish:
     name: Publish GitHub Release
@@ -60,19 +88,20 @@ jobs:
         run: |
           set -euo pipefail
           mkdir -p release-files
-          find dist -type f -name '*.tar.gz' -exec cp {} release-files/ \;
+          find dist -type f \( -name '*.tar.gz' -o -name '*.zip' \) -exec cp {} release-files/ \;
 
       - name: Generate SHA256 checksums
         run: |
           set -euo pipefail
           cd release-files
-          sha256sum *.tar.gz > SHA256SUMS.txt
+          sha256sum *.tar.gz *.zip > SHA256SUMS.txt
 
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
           files: |
             release-files/*.tar.gz
+            release-files/*.zip
             release-files/SHA256SUMS.txt
           generate_release_notes: true
         env:

Cargo.toml

@@ -11,8 +11,4 @@ license = "MIT"
 keywords = ["macho", "dylib", "patcher", "binary", "macos"]
 categories = ["command-line-utilities"]
 
-[package.metadata.docs.rs]
-default-target = "aarch64-apple-darwin"
-targets = ["aarch64-apple-darwin"]
-
 [dependencies]

README.cn.md

@@ -6,8 +6,9 @@
 
 ## 平台支持
 
-- 仅支持：**macOS aarch64（Apple Silicon）**
-- 其它目标会在编译期直接报错（设计如此）。
+- 宿主平台支持：**macOS、Linux、Windows**
+- 处理对象支持：**Mach-O thin / fat binary**
+- 实现只依赖可移植的 `std` 文件 I/O，没有宿主系统专属 API。
 
 ## 功能
 
@@ -20,12 +21,13 @@
 ## 构建
 
 ```bash
-cargo build --release --target aarch64-apple-darwin
+cargo build --release
 ```
 
 生成的可执行文件位于：
 
-- `target/aarch64-apple-darwin/release/insert-dylib`
+- macOS / Linux：`target/release/insert-dylib`
+- Windows：`target/release/insert-dylib.exe`
 
 ## 用法
 
@@ -78,7 +80,7 @@ insert-dylib --ios --dylib-path libarcaea_function.dylib @executable_path/Framew
 
 ## 代码签名说明
 
-若移除了 `LC_CODE_SIGNATURE`，原签名会失效。需要的话请对补丁后的文件重新签名：
+若移除了 `LC_CODE_SIGNATURE`，原签名会失效。需要的话请对补丁后的文件重新签名。下面的 `codesign` 命令本身仅在 macOS 上可用：
 
 ```bash
 codesign --force --sign - MyApp.patched

README.md

@@ -6,8 +6,9 @@ A Rust rewrite of `insert_dylib`: injects a new `LC_LOAD_DYLIB` (or `LC_LOAD_WEA
 
 ## Platform Support
 
-- Supported platform: **macOS aarch64 (Apple Silicon)**
-- Unsupported targets fail at compile time by design.
+- Host platforms: **macOS, Linux, and Windows**
+- Supported inputs: **Mach-O thin and fat binaries**
+- The implementation uses portable `std` file I/O only; no host-OS-specific APIs are required.
 
 ## Features
 
@@ -20,12 +21,13 @@ A Rust rewrite of `insert_dylib`: injects a new `LC_LOAD_DYLIB` (or `LC_LOAD_WEA
 ## Build
 
 ```bash
-cargo build --release --target aarch64-apple-darwin
+cargo build --release
 ```
 
 The binary will be at:
 
-- `target/aarch64-apple-darwin/release/insert-dylib`
+- macOS / Linux: `target/release/insert-dylib`
+- Windows: `target/release/insert-dylib.exe`
 
 ## Usage
 
@@ -78,7 +80,7 @@ insert-dylib --ios --dylib-path libarcaea_function.dylib @executable_path/Framew
 
 ## Code Signing Note
 
-If `LC_CODE_SIGNATURE` is removed, the binary's signature is invalidated. Re-sign the patched binary if needed:
+If `LC_CODE_SIGNATURE` is removed, the binary's signature is invalidated. Re-sign the patched binary if needed. The `codesign` command itself is only available on macOS:
 
 ```bash
 codesign --force --sign - MyApp.patched

examples/classic-tight-headerpad-case/README.md

@@ -13,7 +13,7 @@ This folder is a reproducible failure/success comparison for Mach-O dylib inject
 
 ## Prerequisites
 
-- macOS aarch64 (Apple Silicon)
+- This example itself requires macOS aarch64 (Apple Silicon)
 - `codesign` available in your environment
 
 ## Build and Run (Step-by-Step)

src/main.rs

@@ -7,9 +7,6 @@ use std::path::Path;
 use std::process;
 use std::ptr;
 
-#[cfg(not(all(target_os = "macos", target_arch = "aarch64")))]
-compile_error!("insert-dylib currently supports only macOS aarch64.");
-
 const MH_MAGIC: u32 = 0xfeedface;
 const MH_CIGAM: u32 = 0xcefaedfe;
 const MH_MAGIC_64: u32 = 0xfeedfacf;