AndroidFileTransfer

一款 macOS 桌面应用，用于在 Mac 和 Android 手机之间传输文件，基于 Wails 构建（Go 后端 + React/TypeScript 前端）。

👉 下载最新版

支持两种传输方式，可同时使用：

• WiFi：手机在浏览器中打开一个网址（无需安装应用、无需数据线）来浏览/下载/上传文件到应用运行的本地 HTTP 服务器。
• ADB（USB）：启用 USB 调试后，可浏览手机的文件系统（/sdcard），并直接通过 USB 推送/拉取文件。

1. 前往 Releases 下载 AndroidFileTransfer-x.x.x.dmg。
2. 打开 DMG，把 AndroidFileTransfer.app 拖入 Applications 文件夹。

首次打开提示"无法验证开发者"？

本应用未经 Apple 公证，macOS Gatekeeper 会拦截首次启动。有两种解决方法（任选一种）：

方法一（推荐）：
在 Finder 中找到 AndroidFileTransfer.app，右键单击 → 打开，在弹出窗口中点击"打开"即可。之后双击正常启动。

方法二：
系统设置 → 隐私与安全性 → 在"已阻止使用 AndroidFileTransfer"旁点击"仍要打开"。

• macOS 12 (Monterey) 或更新版本，Apple Silicon 或 Intel 处理器
• 若使用 USB 传输方式，需安装 ADB（android-platform-tools）— 若仅使用 WiFi 传输则可选
• 使用 WiFi 传输时，需要 Android 手机和 Mac 连接到同一个本地网络

ADB（USB）传输方式需要在系统中安装 Android 平台工具并将其添加到 PATH 中。在 macOS 上最简单的方法是使用 Homebrew：

brew install android-platform-tools

验证是否已安装：

adb version

如果未找到 adb，应用仍能正常运行并自动降级到仅 WiFi 模式 — ADB 设备不会出现在设备列表中。

# install frontend deps and build
cd frontend && npm install && npm run build && cd ..

# run in dev mode (hot reload)
wails dev

# build a production app bundle
wails build -platform darwin/universal

构建完成的应用位于 build/bin/AndroidFileTransfer.app。

1. 确保你的 Mac 和 Android 手机已连接到同一个 WiFi 网络。
2. 启动应用，在设备列表中选中 WiFi 设备。右侧会显示二维码、访问网址以及共享设置面板。
3. 在手机上扫描二维码（或在移动浏览器中手动打开形如 http://192.168.1.x:8080 的网址）。
4. 在手机浏览器中浏览你共享的文件：点击文件夹可进入，点击"← 上级"或面包屑返回，点击下载图标保存到手机，或用上传按钮把手机文件发送到 Mac。

Android 手机上无需安装任何应用 — 一切都通过浏览器完成。

为避免把整个 Mac 主目录暴露给同一网络上的其他人，WiFi 共享默认是受控的：

• 仅共享选定项（默认）：手机端只能看到你在共享面板中手动添加的文件和文件夹。未添加的内容完全不可见。
• 共享整个文件夹（高级）：手动切换后，可选择一个根目录，其全部内容对手机可见。切换时会有中文风险提示。

安全约束（两种模式均适用）：

• 手机端看到的路径都是虚拟路径，不会暴露真实的 Mac 绝对路径（如 /Users/...）。
• 任何以 . 开头的隐藏文件或文件夹都不可见、不可下载、也不能被添加为共享项。
• 手机上传的文件统一保存到接收目录（默认 ~/Downloads/AndroidFileTransfer），可在共享面板中修改。上传时手机端指定的路径会被忽略。
• 共享配置保存在 ~/Library/Application Support/AndroidFileTransfer/config.json，重启后保留。

1. 在 Android 手机上，启用开发者选项（设置 → 关于手机 → 连续点击"构建号" 7 次）。
2. 在开发者选项中，启用 USB 调试。
3. 使用 USB 数据线将手机连接到 Mac。
4. 首次连接时，手机会提示 "允许 USB 调试？" — 点击"允许"（并可选择"始终允许来自此计算机的连接"）。
5. 设备应会自动出现在应用的设备列表中。浏览 /sdcard，可从 Mac 拉取文件或推送文件到手机。

如果设备显示为"未授权"，请查看手机屏幕上是否有 USB 调试权限提示，并接受它。

• 首次打开被 Gatekeeper 拦截：右键 → 打开，或系统设置 → 隐私与安全性 → 仍要打开。
• ADB 未安装：应用会显示提示并以仅 WiFi 模式继续运行，而不会崩溃。
• 设备未授权：在手机上接受"允许 USB 调试"的提示。
• WiFi 端口不可用：应用会尝试一个较小的端口范围（8080-8084）；如果所有端口都被占用，应用将报告错误而不是崩溃。请释放一个端口或重新启动应用。

# run backend tests
go test ./...

# build the Go backend
go build ./...

# build the frontend
cd frontend && npm run build

如果这个工具对你有帮助，欢迎请我喝杯咖啡 ☕