# sentry-java

**Repository Path**: nanwenfang/sentry-java

## Basic Information

- **Project Name**: sentry-java
- **Description**: 一款用于统计用户行为、自定义事件、crash log上报到服务端的SDK
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-01-31
- **Last Updated**: 2023-01-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# sentry-java

#### 项目介绍
- 项目名称：sentry-java
- 所属系列：openharmony的第三方组件适配移植
- 功能：一款用于统计用户行为、自定义事件、crash log上报到sentry服务端的SDK
- 项目移植状态：已完成主功能
- 调用差异：无
- 开发版本：sdk6，DevEco Studio2.2 Beta1
- 基线版本：Releases 5.0.1

#### 效果演示  
 登录sentry后台查看记录的异常信息数据
![screenshot1](img/new_video.gif)
#### 安装教程

在moudle级别下的build.gradle文件中添加依赖
 ```
// 添加maven仓库
repositories {
    maven {
        url 'https://s01.oss.sonatype.org/content/repositories/releases/'
    }
}

// 添加依赖库
dependencies {
    implementation 'com.gitee.chinasoft_ohos:sentry-java:1.0.1'
}
 ```

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

#### 使用说明

1.在sentry后台(`https://sentry.io`)申请创建java应用，获取应用dsn标识  
2.在项目中AbilityPackage设置sentry配置。  
```java
    SentryOhos.init(this,
              options -> {
                  options.setDebug(true);
                  options.setEnableNdk(true);
                  options.setDsn("https://xxxxx@o808855.ingest.sentry.io/5804313");
              });
```
3.使用sentry发送普通message到后台

```java
 Sentry.captureMessage("Some message.");
```

4.使用sentry发送自定义异常信息。 

```java
 SentryId sentryId = Sentry.captureException(new Exception("I have feedback"));
            UserFeedback userFeedback = new UserFeedback(sentryId);
            userFeedback.setComments("It broke on Ohos. I don't know why, but this happens.");
            userFeedback.setEmail("john@me.com");
            userFeedback.setName("John Me");
            Sentry.captureUserFeedback(userFeedback);
```


5.使用sentry发送自定义user信息。  

```java
  Sentry.setTag("user_set", "null");
             User user = new User();
             user.setEmail("xxxyyy@123.com");
             user.setId("195.786.258.369");
             Sentry.setUser(user);
```


#### 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

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

#### 版本迭代

- 1.0.1
- 0.0.1-SNAPSHOT

#### 版权和许可信息
[MIT License](LICENSE)