# AppCrawler

**Repository Path**: captainji/AppCrawler

## Basic Information

- **Project Name**: AppCrawler
- **Description**: 基于appium的app自动遍历工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-06-11
- **Last Updated**: 2021-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AppCrawler2 

> 改名为 appcrawler2 以示区分
> 增加了 `demo.yml` 方便快速开始

## 从源代码编译

#### 给 sbt 设置国内源
   ***大坑***
   ***大坑***
   ***大坑***
    
   > 代码中调用了 `com.sun.jdi`，需要复制 `tools.jar` 到 lib 目录

#### 新建文件 `~/.sbt/repositories` 并添加一下内容

   ```
    [repositories]
    local
    huaweicloud-maven: https://repo.huaweicloud.com/repository/maven
    maven-central: https://repo1.maven.org/maven2/
    #maven-central-ivy: https://repo1.maven.org/maven2, [organization]/[module]/(scala_[scalaVersion]/)(sbt_[sbtVersion]/)[revision]/[type]s/[artifact](-[classifier]).[ext]
    sbt-plugin-repo: https://repo.scala-sbt.org/scalasbt/sbt-plugin-releases, [organization]/[module]/(scala_[scalaVersion]/)(sbt_[sbtVersion]/)[revision]/[type]s/[artifact](-[classifier]).[ext]
   ```

#### 运行命令 

   ```
    sbt -Dsbt.override.build.repos=true -v assembly
   ```

#### `target` 目录下寻找生成的 jar 包




一个基于自动遍历的app爬虫工具. 支持android和iOS, 支持真机和模拟器. 最大的特点是灵活性. 可通过配置来设定遍历的规则.

## 为什么做这个工具

* 各大云市场上自动遍历功能都多有限制企业无法自由定制.
* 解决monkey等工具可控性差的缺点
* 发现深层次的UI兼容性问题
* 通过新老版本的diff可以发现每个版本的UI变动范围

## 设计目标

* 自动爬取加上规则引导(完成)
* 支持定制化, 可以自己设定遍历深度(完成)
* 支持插件化, 允许别人改造和增强(完成)
* 支持滑动等更多动作(完成)
* 支持自动截获接口请求(完成)
* 支持新老版本的界面对比(Doing)
* 云端兼容性测试服务利用, 支持Testin MQC MTC(Doing)


## 安装依赖

### mac下安装appium

```bash
#安装node和依赖
brew install node
brew install ideviceinstaller
brew install libimobiledevice
#安装appium
npm install -g appium
#检查appium环境正确性
appium-doctor
```

真机或者模拟器均可. 确保adb devices可以看到就行

### 启动appium

使用此工具需要一定的appium基础知识, 请自行google.  
目前已经在appium 1.5.3下做过测试  

启动appium

```bash
appium --session-override
```

### 下载appcrawler.

最新版本下载地址: [https://pan.baidu.com/s/1dE0JDCH](https://pan.baidu.com/s/1dE0JDCH)

### 运行
工具以jar包方式发布，需要java8以上的运行环境
```bash
java -jar appcrawler.jar  
```

### 快速遍历

```bash
#查看帮助文档
java -jar appcrawler.jar
#运行测试
java -jar appcrawler.jar -a xueqiu.apk
```

### 配置文件运行方式

```bash
#配置文件的方式运行
#Android测试
java -jar appcrawler.jar -c conf/xueqiu.yaml -a xueqiu.apk
#iOS测试
java -jar appcrawler.jar -c conf/xueqiu.yaml -a xueqiu.app
```

### 输出结果

默认在当前目录下会生成一个包含输出结果的目录, 以时间命名. 包含了如下的测试结果

* 所有遍历过的控件组成的思维导图
* 包含了遍历覆盖的html报告
* 用于做diff分析的数据文件

### 示例
![](https://testerhome.com/photo/2016/fa0f926206242ee24eab0c47d2030759.png)

## 更多技术交流

移动测试技术交流社区: [https://testerhome.com](https://testerhome.com)

QQ技术交流群: 177933995

# 更多细节
* [启动参数介绍](doc/启动参数介绍.md)
* [遍历控制](doc/遍历控制.md)
* [Android遍历](doc/Android遍历.md)
* [动作触发器](doc/动作触发器.md)
* [iOS遍历](doc/iOS遍历.md)
* [自动化测试结合](doc/自动化测试结合.md)
* [兼容性测试](doc/兼容性测试.md)
* [XPath表达式学习](doc/XPath表达式学习.md)
* [插件](doc/插件.md)
    * [插件开发](doc/插件开发.md)
    * [代理插件](doc/代理插件.md)
    * [Log插件](doc/Log插件.md)
    * [TagLimit插件](doc/TagLimit插件.md)
* [常见问题](doc/常见问题.md)