{"id":19675301,"url":"https://github.com/zhongantech/za-farmer","last_synced_at":"2025-08-19T10:22:56.927Z","repository":{"id":88140251,"uuid":"188396300","full_name":"ZhongAnTech/za-Farmer","owner":"ZhongAnTech","description":"基于uiautomator2.0 的自动化测试工具","archived":false,"fork":false,"pushed_at":"2019-12-31T09:08:06.000Z","size":669,"stargazers_count":68,"open_issues_count":0,"forks_count":21,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-05T12:42:03.439Z","etag":null,"topics":["android","cli","java","uiautomator2"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZhongAnTech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-24T09:45:07.000Z","updated_at":"2025-03-03T10:37:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"972f8753-5013-4c4a-a985-357b20be88f4","html_url":"https://github.com/ZhongAnTech/za-Farmer","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZhongAnTech%2Fza-Farmer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZhongAnTech%2Fza-Farmer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZhongAnTech%2Fza-Farmer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZhongAnTech%2Fza-Farmer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZhongAnTech","download_url":"https://codeload.github.com/ZhongAnTech/za-Farmer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251420880,"owners_count":21586696,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","cli","java","uiautomator2"],"created_at":"2024-11-11T17:23:02.744Z","updated_at":"2025-04-29T02:30:32.760Z","avatar_url":"https://github.com/ZhongAnTech.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# za-Farmer\n  [![Build Status](https://travis-ci.com/ZhonganTechQA/za-Farmer.svg?branch=master)](https://travis-ci.com/ZhonganTechQA/za-Farmer)\n  \nza-Farmer 是一个基于Uiautomator2.0 的命令行自动化工具，你可以通过命令行驱动Uiautomator进行Android自动化测试。\n\n我们封装了Android大部分常用操作，你可以很容易的使用它实现你的Android自动化需求。\n\n它可以帮你自动处理权限弹窗，并配套有完整的执行日志和过程截图，帮助你还原执行过程中的情况。\n\n## 内容列表\n- [特性](#特性 )\n- [构建](#构建 )\n- [安装](#安装 )\n- [简单示例](#简单示例 )\n- [步骤介绍](./markdown/stepIntroduce.md)\n\n\n\n## 特性\n### 1、步骤执行自动截图\n执行过程中每个步骤都会截图记录操作的元素或标注执行轨迹\n\n\u003cimg src=\"./markdown/image/1560233295793.jpg\" width = \"150\" height = \"280\" alt=\"1560233295793.jpg\" \u003e\u003cimg src=\"./markdown/image/1560305600360.jpg\" width = \"150\" height = \"280\" alt=\"1560305600360.jpg\" \u003e\n\n\n### 2、权限弹框自动处理\n对于应用程序弹出的权限弹框进行自动处理\u003cbr/\u003e\n\u003cimg src=\"./markdown/image/1560307039959.jpg\" width = \"150\" height = \"280\" alt=\"1560307039959.jpg\" \u003e\u003cbr/\u003e\n\n\n\n## 构建\n\n```bash\ngit clone https://github.com/ZhonganTechQA/za-Farmer.git\ncd ./za-Farmer\n./gradlew clean assembleAndroidTest assembleDebug\n```\n成功后生成两个apk\n\n./app/build/outputs/apk/androidTest/debug/app-debug-androidTest.apk\n\n./app/build/outputs/apk/debug/app-debug.apk\n\n## 安装\n\n- 安卓5.0以下安装方式:\n\n```bash\nadb install  ./app/build/outputs/apk/androidTest/debug/app-debug-androidTest.apk\n```\n```bash\nadb install  ./app/build/outputs/apk/debug/app-debug.apk\n```\n- 安卓5.0以上安装方式:\n\n```bash\nadb install -g ./app/build/outputs/apk/androidTest/debug/app-debug-androidTest.apk\n```\n```bash\nadb install -g ./app/build/outputs/apk/debug/app-debug.apk\n```\n#### 注意:-g 参数为授予所有运行权限，安卓5.0以下不支持\n\n\n\n## 简单示例\n- #### 点击元素\n\u003cimg src=\"./markdown/image/审查元素.jpg\" width = \"400\" height = \"300\" alt=\"1559791932003.jpg\" \u003e\u003cbr/\u003e\n```bash\n$ adb shell am instrument -w  -e class 'com.smart.farmer.ExampleInstrumentedTest#step'  \\\n -e step-action click \\\n -e step-elementText 设置  \\\n com.smart.farmer.test/android.support.test.runner.AndroidJUnitRunner\n```\n\n 执行完成后导出过程截图\n```bash\n$ adb pull /storage/emulated/0/Android/data/com.smart.farmer/cache/  ./Desktop/\n```\n\n\u003cimg src=\"./markdown/image/1559791932003.jpg\" width = \"150\" height = \"280\" alt=\"1559791932003.jpg\" \u003e\u003cbr/\u003e\n\n- #### 点击元素,自动处理权限弹框\n\n```bash\n$ adb shell am instrument -w  -e class 'com.smart.farmer.ExampleInstrumentedTest#step' \\ \n -e step-action click \n -e step-elementText 随便看看 \n -e step-autoPermit true  com.smart.farmer.test/android.support.test.runner.AndroidJUnitRunner\n```\n\u003cimg src=\"./markdown/image/1560851185191.jpg\" width = \"150\" height = \"280\" alt=\"1560851185191.jpg\" \u003e\u003cimg src=\"./markdown/image/1560851188145.jpg\" width = \"150\" height = \"280\" alt=\"1560851188145.jpg\" \u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhongantech%2Fza-farmer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhongantech%2Fza-farmer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhongantech%2Fza-farmer/lists"}