# matomo-sdk-ohos

**Repository Path**: chinasoft_ohos/matomo-sdk-ohos

## Basic Information

- **Project Name**: matomo-sdk-ohos
- **Description**: 可以解析每个按钮的点击事件所上报的数据
- **Primary Language**: Java
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 10
- **Created**: 2021-04-13
- **Last Updated**: 2024-05-30

## Categories & Tags

**Categories**: harmonyos-button

**Tags**: None

## README

# matomo-sdk-ohos

## 项目介绍
项目名称：打点数据上报

所属系列：openharmony的第三方组件适配移植

功能：可以解析每个按钮的点击事件所上报的数据

基线版本：Release v4.1.2

项目移植状态：有差异

调用差异：无

开发版本：sdk6，DevEco Studio 2.2 Beta1

外部库依赖：matomo-sdk-ohos项目中的tracker库


## 效果展示

<img src="https://gitee.com/chinasoft_ohos/matomo-sdk-ohos/raw/master/img/demo.gif"></img>

## 安装教程
1、在项目根目录下的build.gradle文件中
 ```gradle
allprojects {
    repositories {
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
}
```
2.在entry模块的build.gradle文件中
 ```gradle
 dependencies {
    implementation('com.gitee.chinasoft_ohos:matomo-sdk-ohos:1.0.0')
    ......  
 }
```

在sdk6，DevEco Studio 2.2 Beta1下项目可直接运行 如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件 并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下


## 使用说明

1.在AbilityPackage子类中初始化上报数据的基类和url

2.布局定义按钮

3.初始化按钮事件

4.在点击事件里面绑定上报数据

```
@Override
public TrackerBuilder onCreateTrackerConfig() {
    return TrackerBuilder.createDefault("https://demo.matomo.org/matomo.php", 53);
}
TrackHelper.track(new TrackMe().set(QueryParams.SESSION_START, 1))
        .screen("/")
        .title("Main screen")
        .with(getTracker()));
```

## 测试信息
CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异


## 版本迭代

- 1.0.0

## 版权和许可信息
```
Android SDK for Matomo is released under the BSD-3 Clause license, see LICENSE.

```