Matomo SDK for Android 使用教程

1. 项目目录结构及介绍

Matomo SDK for Android 是一个用于将 Android 应用的分析数据发送到 Matomo 服务器的开源库。以下是项目的目录结构及其介绍：

matomo-sdk-android/
├── app/                        # 示例应用目录，用于演示如何集成SDK
│   ├── src/                    # 源代码目录
│   │   ├── main/               # 主目录
│   │   │   ├── java/           # Java源代码
│   │   │   ├── kotlin/         # Kotlin源代码
│   │   │   ├── res/            # 资源目录，包含布局、图片等
│   │   │   └── AndroidManifest.xml # 应用配置文件
│   │   └── test/               # 测试目录
│   └── build.gradle            # 模块构建文件
├── build/                      # 构建目录，构建产物存放在这里
├── gradle/                     # Gradle Wrapper目录
│   ├── wrapper/                # 包含Gradle Wrapper的脚本和属性文件
│   └── gradlew                 # Gradle Wrapper的脚本
├── gradlew                     # Gradle Wrapper的脚本
├── jitpack.yml                 # JitPack构建配置文件
├── settings.gradle             # 项目设置文件
├── .gitignore                  # Git忽略文件
├── LICENSE                     # 许可证文件
└── README.md                   # 项目说明文件

2. 项目的启动文件介绍

项目的启动文件主要是 app/src/main/java/YourApplication.java。这是一个继承自 Application 的类，用于在应用启动时初始化 Tracker 实例。

import org.matomo.sdk.TrackerBuilder;

public class YourApplication extends Application {
    private Tracker tracker;

    public synchronized Tracker getTracker() {
        if (tracker == null) {
            tracker = TrackerBuilder.createDefault("http://domain.tld/matomo.php", 1)
                    .build(Matomo.getInstance(this));
        }
        return tracker;
    }
}

在这段代码中，YourApplication 类通过 getTracker() 方法提供 Tracker 实例的单例访问。Tracker 实例用于跟踪应用的各种事件和数据。

3. 项目的配置文件介绍

项目的配置文件主要包括 app/build.gradle 和 gradle.properties。

• app/build.gradle 文件定义了应用模块的构建脚本，包括依赖管理、构建类型和任务等。

apply plugin: 'com.android.application'

android {
    compileSdkVersion <latest-compile-sdk-version>
    defaultConfig {
        applicationId "com.example.matomo_sdk_android"
        minSdkVersion <latest-min-sdk-version>
        targetSdkVersion <latest-target-sdk-version>
        versionCode <latest-version-code>
        versionName "<latest-version-name>"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'com.github.matomo-org:matomo-sdk-android:<latest-version>'
}

• gradle.properties 文件包含项目全局的 Gradle 属性设置，如 Gradle Wrapper 的版本。

# Project-wide Gradle settings.

# Specifies the JVM arguments used for the daemon process.
# The setting is particularly useful for tuning memory usage of the daemon process.
org.gradle.jvmargs=-Xmx1024m

# Set the Gradle JVM arguments for the daemon process for all Gradle incubating tasks.
org.gradle.jvmargs incubating=-Xmx512m

# Enable Gradle'sdaemon mode.
org.gradle.daemon=true

确保在 app/build.gradle 文件中正确配置了 Matomo SDK for Android 的依赖，以便于在项目中使用。