adb-sync

Usage

Note: The supported Android version is Android 7.0 Nougat (API Version 24) and above, because it depends on ifaddrs which is supported officially only above this version.

Usage: adb-sync [OPTIONS] <ANDROID_DIR> <HOST_DIR>

Arguments:
  <ANDROID_DIR>
          Path of the source directory

  <HOST_DIR>
          Path of the destination directory

Options:
      --android-bin-search-path <ANDROID_BIN_SEARCH_PATH>
          Search `adb-sync-android` in this path. Default to where `adb-sync` locates
          
          [default: .]

      --no-stdio
          Do not fall back to the stdio method when Android IP is unavailable

      --no-tcp
          Use stdio only

      --skip-failed
          Skip indexing failure

      --android-ip <ANDROID_IP>
          Manually specify the Android IP instead of automatic detection.
          
          Only used in TCP mode.

  -h, --help
          Print help (see a summary with '-h')

Build

• Set up Rust with NDK toolchain

  An example configuration file (replace these paths with yours):

  # <project>/.cargo/config
  
  [build]
  [target.aarch64-linux-android]
  linker = "/home/bczhc/bin/AndroidSdk/ndk-ln/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android29-clang"
  ar = "/home/bczhc/bin/AndroidSdk/ndk-ln/toolchains/llvm/prebuilt/linux-x86_64/bin/llvm-ar"
  
  [env]
  TARGET_CC = "/home/bczhc/bin/AndroidSdk/ndk-ln/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android29-clang"
  TARGET_AR = "/home/bczhc/bin/AndroidSdk/ndk-ln/toolchains/llvm/prebuilt/linux-x86_64/bin/llvm-ar"

• Install Android targets using rustup:

  rustup target add aarch64-linux-android x86_64-unknown-linux-musl

  If your Android architecture is not aarch64, choose some others (also change $android_target in ./build-rust correspondingly):

  • aarch64-linux-android
  • armv7-linux-androideabi
  • i686-linux-android
  • x86_64-linux-android

• Run ./build-rust

Run

After ./build-rust, run:

./adb-sync

Limitations and Notes

• Relies on mtimes
• No multiple files/directories and file exclusion support
• Empty directories won't be synced
• Only supports regular files (that's, totally ignores symlink, pipe etc.; no reflink or hard link awareness)

I've found project https://github.com/google/adb-sync and https://github.com/jb2170/better-adb-sync, but their sync speed is quite slow; can't fulfill my personal requirements :).

Script implementation

For the initial script implementation, see script-impl branch.

For syncing over network, see https://github.com/bczhc/FileSync