ApkRename 项目使用教程

ApkRename 项目使用教程

1. 项目目录结构及介绍

ApkRename 项目的目录结构如下：

ApkRename/
├── lib/
│   └── setAxmlPkgName.jar
├── apkRename.sh
├── apkRenameAndInstall.sh
├── apkSign.sh
├── LICENSE
└── README.txt

目录结构介绍

• lib/: 包含项目所需的 Java 库文件 setAxmlPkgName.jar，用于修改 APK 的包名。
• apkRename.sh: 主要脚本文件，用于修改 APK 的包名。
• apkRenameAndInstall.sh: 脚本文件，用于修改 APK 的包名并安装到设备上。
• apkSign.sh: 脚本文件，用于对修改后的 APK 进行签名。
• LICENSE: 项目的开源许可证文件，采用 MIT 许可证。
• README.txt: 项目的说明文件，包含项目的简要介绍和使用说明。

2. 项目启动文件介绍

apkRename.sh

apkRename.sh 是项目的主要启动文件，用于修改 APK 的包名。以下是该脚本的使用方法：

Usage: apkRename.sh [OPTIONS] apkPath_or_packageName newPackageName

参数说明

• apkPath_or_packageName: APK 文件路径或包名。
• newPackageName: 新的包名。

选项

• -H <host>: ADB 服务器的主机名（默认：localhost）。
• -P <port>: ADB 服务器的端口（默认：5037）。
• -s <devSerialNumber>: 设备序列号或标识符。

示例

apkRename.sh /tmp/test.apk com.example.newapp
apkRename.sh com.example.app com.example.newapp

apkRenameAndInstall.sh

apkRenameAndInstall.sh 脚本用于修改 APK 的包名并安装到设备上。以下是该脚本的使用方法：

Usage: apkRenameAndInstall.sh [OPTIONS] packageName newPackageName debugKeyStoreFile

参数说明

• packageName: 当前的包名。
• newPackageName: 新的包名。
• debugKeyStoreFile: 调试密钥库文件路径。

选项

• -H <host>: ADB 服务器的主机名（默认：localhost）。
• -P <port>: ADB 服务器的端口（默认：5037）。
• -s <devSerialNumber>: 设备序列号或标识符。
• --update: 更新应用。

示例

apkRenameAndInstall.sh com.android.browser com.android.mybrowser ~/android/debug.keystore

3. 项目配置文件介绍

ApkRename 项目没有传统的配置文件，所有的配置和操作都通过命令行参数进行。主要的配置参数包括：

• ADB 服务器配置: 通过 -H 和 -P 选项指定 ADB 服务器的主机名和端口。
• 设备配置: 通过 -s 选项指定设备的序列号或标识符。
• 包名配置: 通过 apkPath_or_packageName 和 newPackageName 参数指定 APK 文件路径或包名以及新的包名。

通过这些配置参数，用户可以灵活地修改 APK 的包名并进行相应的操作。