安装指南

下载与安装ADB

1. 下载ADB：访问 Android 开发者官网 下载适合您操作系统的 ADB 工具包。
2. 解压文件：将下载的工具包解压到您的电脑上，确保 platform-tools 文件夹包含所有必要的可执行文件（如 adb.exe）。
3. 添加环境变量：
   • Windows：将 platform-tools 路径添加到系统路径变量中。
   • macOS/Linux：将 platform-tools 添加到 ~/.bashrc 或 ~/.zshrc 文件中。

连接设备

1. 开启调试模式：
   • 在您的 Android 设备上，依次打开以下设置：

     设置 -> 系统 -> 关于手机 -> 软件信息 -> 重复点击“版本号”七次 -> 开发者选项
     

   • 启用“USB 调试”和“允许模拟器的网络代理”。
2. 连接设备：
   • 使用 USB 数据线将您的 Android 设备与电脑连接。
   • 打开命令行工具（如 Windows 的 CMD 或 macOS/Linux 的终端）。
   • 输入以下命令检查设备是否正确连接：

     adb devices
     

   • 如果设备列表中显示了您的设备，则表示连接成功。

验证安装

1. 运行示例命令：
   • 在命令行工具中输入以下命令，验证 ADB 是否正常工作：

     adb shell pm list packages
     

   • 如果输出了设备上的应用列表，则表示 ADB 已正确安装并配置。

联系人创建工具

简介

这个工具允许您通过ADB在Android设备上轻松创建联系人。

先决条件

• Python 3.x 或更高版本
• ADB（Android Debug Bridge）已安装且配置完成
• Android 设备已连接并授权ADB使用

使用说明

基本用法

直接运行脚本：

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")

代码说明

1. 启动添加联系人活动：

   os.system("adb shell am start -a android.intent.action.ADD_VIA_ADDRESS")
   

2. 输入账户名：

   os.system(f"adb shell input text {account_name}")
   

3. 设置账户类型：

   os.system(f"adb shell content insert --uri content://com.android.contacts/contacts --values name={account_type}")
   

4. 保存联系人：

   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脚本来实现联系人自动添加的功能示例。希望这些内容对您有所帮助！