🚀 联系人创建工具
本工具借助 ADB 让您能轻松在 Android 设备上创建联系人，通过 Python 脚本实现自动化管理，操作简单且功能实用。
🚀 快速开始
下载与安装 ADB
- 下载 ADB：访问 Android 开发者官网 下载适配您操作系统的 ADB 工具包。
- 解压文件：把下载的工具包解压到电脑，保证
platform-tools文件夹涵盖所有必要可执行文件（如adb.exe）。 - 添加环境变量：
- Windows：将
platform-tools路径添加到系统路径变量。 - macOS/Linux：把
platform-tools添加到~/.bashrc或~/.zshrc文件。
- Windows：将
连接设备
- 开启调试模式：
- 在 Android 设备上，依次打开如下设置：
设置 -> 系统 -> 关于手机 -> 软件信息 -> 重复点击“版本号”七次 -> 开发者选项- 启用“USB 调试”和“允许模拟器的网络代理”。
- 连接设备：
- 用 USB 数据线把 Android 设备和电脑相连。
- 打开命令行工具（如 Windows 的 CMD 或 macOS/Linux 的终端）。
- 输入以下命令检查设备是否正确连接：
adb devices- 若设备列表显示您的设备，即连接成功。
验证安装
- 运行示例命令：
- 在命令行工具中输入以下命令，验证 ADB 是否正常工作：
adb shell pm list packages- 若输出设备上的应用列表，表明 ADB 已正确安装并配置。
📦 安装指南
上述快速开始部分已详细阐述了 ADB 的下载、安装、设备连接及验证安装的步骤，按照这些步骤操作，您就能完成 ADB 的安装与配置。
✨ 主要特性
- 借助 ADB 和 Python 脚本，可在 Android 设备上自动化创建联系人。
- 支持基本用法创建默认联系人，也支持高级用法自定义账户名和类型。
- 能输出包含操作结果和错误信息的 JSON 对象，便于查看和处理。
💻 使用示例
基本用法
直接运行脚本：
python create_contact.py
这将创建一个默认的联系人，具体信息如下：
- 账户名："你的账户名"
- 账户类型： "com.google"
高级用法
您可以提供自定义账户名和类型，使用 JSON 字符串：
python create_contact.py '{"account_name": "your_account", "account_type": "com.google"}'
📚 详细文档
输出
脚本输出一个 JSON 对象，包含以下内容：
success：布尔值，表示操作是否成功。message：来自命令的任何输出或错误信息。
示例输出（成功）
{"success": true, "message": ""}
错误处理
- 若 ADB 不可用或设备未连接，脚本将返回一个错误。
- 无效的 JSON 输入会导致错误消息。
- 任何 ADB 命令错误都会被捕获并记录在
message字段中。
注意事项
⚠️ 重要提示
- 确保您的 Android 设备已连接且授权 ADB 使用。
- 设备屏幕应处于解锁状态。
- 部分设备可能需要额外权限才能创建联系人。
🔧 技术细节
Python 脚本示例
以下是用于通过 ADB 创建联系人的 Python 脚本：
import os
def create_contact(account_name, account_type):
# 启动添加联系人活动
os.system("adb shell am start -a android.intent.action.ADD_VIA_ADDRESS")
# 等待设备响应（可调时间根据需要）
import time
time.sleep(2)
# 输入账户名
os.system(f"adb shell input text {account_name}")
# 设置账户类型
os.system(f"adb shell content insert --uri content://com.android.contacts/contacts --values name={account_type}")
# 保存联系人
os.system("adb shell keyevent 66") # 按下“确定”键
# 示例用法
create_contact("your_account", "com.google")
代码说明
- 启动添加联系人活动：
os.system("adb shell am start -a android.intent.action.ADD_VIA_ADDRESS")
- 输入账户名：
os.system(f"adb shell input text {account_name}")
- 设置账户类型：
os.system(f"adb shell content insert --uri content://com.android.contacts/contacts --values name={account_type}")
- 保存联系人：
os.system("adb shell keyevent 66")
扩展说明
- 修改账户类型：您可以将
account_type参数替换为其他类型的账户，例如"com.yahoo"或"com.microsoft"。 - 自定义输入逻辑：根据需要调整输入时间和命令。
- 批量创建联系人：可以编写循环脚本以批量添加多个联系人。
📚 常见问题解答
1. 如何验证 ADB 是否正常工作？
在命令行工具中运行以下命令：
adb devices
如果设备列表中显示了您的设备，则表示 ADB 已正确配置。
2. 设备未出现在 adb devices 列表中怎么办？
- 确保设备已启用 USB 调试。
- 尝试重新连接设备。
- 检查是否安装了正确的 USB 驱动程序。
3. 如何解决 ADB 权限问题？
在命令行工具中运行以下命令：
adb shell pm grant com.android.contacts.permission.WRITE_CONTACTS
4. 脚本无法创建联系人怎么办？
检查是否有足够的设备权限，并确保账户类型正确无误。
总结
通过 ADB 和 Python 脚本，您可以自动化管理 Android 设备上的联系人。本文详细介绍了 ADB 的安装与配置方法，并提供了使用 Python 脚本来实现联系人自动添加的功能示例。希望这些内容对您有所帮助！