浏览代码

add cn doc

/main
meng.yan 3 年前
当前提交
67c429fb
共有 2 个文件被更改,包括 124 次插入20 次删除
  1. 3
      Documentation/apm.md
  2. 141
      Documentation/cn/Documentation/apm.md

3
Documentation/apm.md


### Optional: Using APM
1. [Creating a Custom Trace. ](https://developer.huawei.com/consumer/en/doc/development/AppGallery-connect-Guides/agc-apms-addtrace)
2. [Using Annotation @AddCustomTrace](https://developer.huawei.com/consumer/en/doc/development/AppGallery-connect-Guides/agc-apms-addcustomtrace)
(note:At present, this function can only be applied to the main assembly, if the user code is in a custom assembly, it cannot be parsed)
3. [Adding Indicators to Monitor Specific Network Requests](https://developer.huawei.com/consumer/en/doc/development/AppGallery-connect-Guides/agc-apms-addnetworkmeasure)
4. [Viewing Debug Logs](https://developer.huawei.com/consumer/en/doc/development/AppGallery-connect-Guides/agc-apms-viewlog)
5. [Configuring the AndroidManifest.xml File](https://developer.huawei.com/consumer/en/doc/development/AppGallery-connect-Guides/agc-apms-configuremanifest)

141
Documentation/cn/Documentation/apm.md


3. 在`Assets/Plugins/Android/` 目录中打开`baseProjectTemplate.gradle`文件
添加以下配置:
```
allprojects {

maven {url 'https://developer.huawei.com/repo/'}
}
}
buildscript {
repositories {
google()

}
buildscript {
dependencies {
classpath 'com.huawei.agconnect:agcp:1.4.2.301'

### 2. 集成APM SDK
步骤请参考 [集成APM SDK](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-apmssdk)
步骤请参考 [集成APM SDK](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-apmssdk)
集成APM SDK后,APM SDK将自动采集应用的[启动性能数据](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-appstart)、[屏幕性能数据](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-appscreen)。

### 3. 集成APM插件
步骤请参考 [集成APM插件](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-apmsplugin)
步骤请参考 [集成APM插件](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-apmsplugin)
APM插件利用检测(instrumentation)技术,实现[HTTP/HTTPS网络请求性能数据](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-appnetwork)的无侵入采集。请按如下步骤将APM插件添加到您的应用:

apply plugin: 'com.huawei.agconnect.apms'
// Apply the AGC plugin
apply plugin: 'com.huawei.agconnect'
```
2. 将APM插件添加到`baseProjectTemplate.gradle`文件中。

classpath 'com.huawei.agconnect:agconnect-apms-plugin:1.4.1.303'
}
}
### 4.集成APM Game SDK(可选)
将APM Game SDK依赖项添加到`launcherTemplate.gradle`文件中(通常在app目录中)。
```
dependencies {
// ...
// Add APM SDK library dependency
implementation 'com.huawei.agconnect:agconnect-apms:1.5.2.300'
implementation 'com.huawei.agconnect:agconnect-apms-game:1.5.2.303'
}
```
请参考[查看性能监控数据](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-viewdata)
请参考[查看性能监控数据](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-viewdata)
### 可选:使用APM

2、[使用@AddCustomTrace跟踪方法耗时](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-addcustomtrace)
(注意:目前此功能只能应用于主程序集,若用户代码在自定义程序集中则无法解析)
3、[添加针对特定网络请求的监控指标](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-addnetworkmeasure)
4、[查看调试日志](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-viewlog)

### 可选:使用APM Game SDK
在游戏开始时的初始化方法中,调用APMS的startGamePlugin()方法来启用该SDK。
```
void Start()
{
// In order to start APMS Game Plugin, you need to call this method
GameAPM.getInstance().start();
// Your own business code
// ...
}
```
```
void OnDestroy() {
// In order to start APMS Game Plugin, you need to call this method
GameAPM.getInstance().stop();
// Your own business code
// ...
}
```
为了能够快速发现场景加载时间是否超过正常范围,可以调用APMS的 startLoadingScene(GameAttribue gameAttribute) 和 stopLoadingScene(String scene) 来记录场景加载时间。
```
public void scenceLoadToGame()
{
// start record the loading scene time
String scene = GameAPM.getInstance().startLoadingScene(new GameAttribute("Game", LoadingState.NOT_LOADING));
SceneManager.LoadScene("Game");
// Other code
// ...
// stop record the loading scene time
GameAPM.getInstance().stopLoadingScene(scene);
}
```
前提条件
1. 您的应用已启用APM服务。
2. 您的应用已集成APM Game SDK,并在设备上运行。
查看游戏场景分析
1. 登录AppGallery Connect网站,点击“我的项目”。
2. 在项目列表中找到您的项目,在项目下的应用列表中选择需要查看的应用。
3. 选择“质量 > 性能管理”,进入“应用性能管理”页面。
4. 点击“体验分析->游戏场景分析",进入游戏场景分析页面。
更多详细信息,请参阅本文档的附录。
### 设置场景

```
void Start()
{
![Images/apm/apm_settingup8.png](Images/apm/apm_settingup8.png)
![Images/apm/apm_settingup8.png](Images/apm/apm_settingup8.png)
### 演示项目

![Images/apm/apm_11.png](Images/apm/apm_11.png)
### 附录
#### APM Game Plugin 数据安全说明
工作方式
- APM Game Plugin随应用打包,在用户启动应用时开始工作,并自动采集应用性能数据。当用户关闭应用时,Plugin会停止采集应用性能数据。
权限说明
- 无
收集数据
1. 基础数据属性
- 应用基础属性:应用名称、应用版本名称、应用版本号、应用包名(应用ID)。
- 设备基础属性:设备厂商、设备架构、设备型号、屏幕大小、分辨率、屏幕类型(超大、大、中、小、未知)、屏幕刷新频率、CPU型号、CPU核数、内存大小、磁盘大小、用户CPU时长、系统CPU时长、最大堆内存、已用堆内存。
- 平台基础属性:操作系统名称、操作系统版本、ROM名称、ROM版本、APM SDK版本、AAID、AGC cpID、AGC productID、AGC ClientID、AGC AppID。
- 运行时基础属性:充电状态、电量大小、网络类型、屏幕方向、应用前后台状态、APM SDK会话ID、可用磁盘空间、应用内存使用量。
- 用户设置属性:默认时区设置、默认语言设置、DNS设置。
- 自定义跟踪记录属性:开发者设置的自定义属性。
2. 指标数据
- 帧率数据:场景名称、加载状态、帧速率数量。
- 加载数据:场景名称、加载状态、加载时长。
3. 数据安全保护
- APM Game Plugin对采集数据进行本地加密,加密后的数据通过HTTPS安全协议传输至APM服务器。
- 华为严格遵循《一般数据保护条例》(GDPR) ,华为也致力于帮助开发者在遵循GDPR规定的前提下取得成功。GDPR规定了数据控制者和数据处理者的义务,使用该服务时,开发者扮演着“数据控制者”的角色,而华为是“数据处理者”。数据处于开发者的控制之下,华为只在“数据处理者”义务和权利范围内处理数据,而开发者有责任遵循GDPR规定,承担“数据控制者“的义务。
正在加载...
取消
保存