# mechanic-android-public

**Repository Path**: bbavip/mechanic-android-public

## Basic Information

- **Project Name**: mechanic-android-public
- **Description**: 开放检测demo
- **Primary Language**: Android
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-08-18
- **Last Updated**: 2023-07-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### AutoX3 Android SDK

### 简介

Android SDK是AutoX3为客户端实现快速检测而提供给开发者的整套UI+接口的解决方式。

targetSdkVersion 30

minSdkVersion 19

 **$new_version = 1.1.0_110102** 


### 安装引入

 **1.在project的build.gradle中配置一下内容:** 

    
   ```
   buildscript {
       repositories {
           maven {url 'https://maven.aliyun.com/repository/public/'}
           maven { url 'https://jitpack.io' }
           google()
       }
       ...
   }
    
   allprojects {
       repositories {
           maven {url 'https://maven.aliyun.com/repository/public/'}
           maven { url 'https://jitpack.io' }
           google()
       }
   }
   ```

 **2.在app的build.gradle中配置一下内容:** 


   ```
   implementation 'com.autox3:mechanic-public:$new_version'
   ```

  添加如上配置之后，点击编译，等待编译成功.


### 快速上手

 **1.SDK初始化** 

  在App启动时初始化SDK,推荐在Application中(主线程中进行初始化)


    ```
    @Override
    public void onCreate() {
       super.onCreate();
       AutoX3App.init(this);
    }
    ```

 
 **2.获取平台访问凭证。** 

  在第三方平台获取到AutoX3的访问凭证之后，需要使用此凭证同步到AutoX3。

  通过AutoX3App.login()方法进行同步


  ```
  /**
   * accessKey 第三方平台获取到的AutoX3的访问凭证
   * OpenBaseUrl AutoX3提供给第三方平台的开放请求域名
   */
   AutoX3App.login(accessKey,Autox3Constant.OpenBaseUrl);
  ```

 **3.创建检测单完成之后，需要调用AutoX3的检测开放模块并传递参数** 
    
  IAloneEventCallback为操作回调，sdk内部的操作都会通过此回调通知给第三方用户。

  iOnCancelWork 取消施工回调

  iOnCompleteWork  结束施工回调

  如若不需要回调通知，则不需要实现此回调。
    
  ```
  /**
   * 跳转到检测单
   * workOrderId 检测单ID
   * serviceOrderId 接车单ID
   */
    AutoX3App.startHealthCheck(workOrderId, serviceOrderId, new IAloneEventCallback() {
       @Override
       public void iOnCancelWork(int workOrderId) {
          Toast.makeText(MainActivity.this,"取消成功",Toast.LENGTH_LONG).show();
       }
    
       @Override
       public void iOnCompleteWork(int workOrderId) {
           Toast.makeText(MainActivity.this,"完成施工",Toast.LENGTH_LONG).show();
       }
    });

  /**
   * 跳转到施工单
   * workOrderId 施工单ID
   * serviceOrderId 接车单ID
   */
    AutoX3App.startWorkOrder(workOrderId, serviceOrderId, new IAloneEventCallback() {
       @Override
       public void iOnCancelWork(int workOrderId) {
          Toast.makeText(MainActivity.this,"取消成功",Toast.LENGTH_LONG).show();
       }
    
       @Override
       public void iOnCompleteWork(int workOrderId) {
           Toast.makeText(MainActivity.this,"完成施工",Toast.LENGTH_LONG).show();
       }
    });

  ```


### 常见问题


1.清单文件合并失败

 ![输入图片说明](https://images.gitee.com/uploads/images/2021/0824/100224_b0e54d73_1781720.jpeg "1629770150997.jpg")

  sdk 目前支持的最低android sdk版本为19，将主app中的minSdkVersion设置为高于或等于19，点击编译即可成功

2.最大方法数超过65535

  ![输入图片说明](https://images.gitee.com/uploads/images/2021/0824/100603_558aae49_1781720.jpeg "1629770725146.jpg")

  解决方法是在build.gradle的defaultConfig中加入如下代码  **multiDexEnabled true** 

3. 如果主APP的targetSdkVersion 是30 ， 则AndroidManifest需要配置 ScopedStorage