Skip to content

环境配置

目前5+ App通过第三方5+原生插件项目扩展原生能力需要支持本地离线打包,请参考官方文档搭建好App本地离线打包。

一、安装SDK

Android请参考官方Android集成指南 iOS请参考官方iOS集成指南

二、安装5+插件

这里获取5+插件和SDK

Android配置
  1. Android文件夹下的 sharetrace-5plus-plugin-sdk_v1.0.0.aar 拷贝到项目的app/libs文件夹下
  2. js目录下的sharetraceplugin.js拷贝到项目工程app/src/main/assets/目录中的www资源的 js 文件目录下
  3. 修改项目的app/src/main/assets/data/目录下的dcloud_properties.xml文件
xml
<properties>
    <features>
        <!-- 其他配置-->
        <feature name="sharetraceplugin" value="com.sharetrace.plugin.SharetracePlugin"/>
    </features>
    
    <services>
        <!-- 其他配置-->
        <feature name="sharetraceplugin" value="com.sharetrace.plugin.SharetracePlugin"/>
    </services>
</properties>
  1. 修改应用的 manifest.json
json
{
    "id": "H5Plugin",
    "name": "H5Plugin",
    "version": {
        "name": "0.1.0",
        "code": "10"
    },
    "permissions": {
        ....其他配置
        "sharetraceplugin": {
            "description": "Sharetrace Plugin"
        }
    }
}
iOS配置
  1. iOS文件夹下的所有文件拖进去Xcode项目工程主目录下
  2. 修改PandoraAPI.bundlefeature.plist文件,增加以下内容
xml
    <key>sharetraceplugin</key>
    <dict>
        <key>class</key>
        <string>SharetracePlugin</string>
        <key>global</key>
        <true/>
        <key>autostart</key>
        <true/>
    </dict>
  1. 修改应用的 manifest.json
json
{
    "id": "H5Plugin",
    "name": "H5Plugin",
    "version": {
        "name": "0.1.0",
        "code": "10"
    },
    "permissions": {
        ....其他配置
        "sharetraceplugin": {
            "description": "Sharetrace Plugin"
        }
    }
}

三、使用5+插件

VUE

javascript
<template>
    <view>
		<button @click="getInstallTrace">getInstallTrace</button>
    </view>
</template>

<script>
// 扩展的 js 文件的位置:common/plugins.js
var plugins = require('../../common/sharetraceplugin.js');
export default {
    data() {
        return {
            plugins: plugins
        };
    },
    methods: {
		getInstallTrace() {
			this.plugins.getInstallTrace(
				function(result) {
					uni.showToast({title:JSON.stringify(result),icon:'none'});
				}
			);
		},
    }
};
</script>

HTML5

javascript
<!DOCTYPE HTML>
<html>
	<head>
		<script type="text/javascript" src="./js/sharetraceplugin.js"></script>
		<script type="text/javascript">
            function getInstallTrace() {
                plus.sharetraceplugin.getInstallTrace(
                    function(result) {
                        alert(JSON.stringify(result))
                        });
            }
		</script>
	</head>
	<body>
        <div class="button" onclick="getInstallTrace()">getInstallTrace()</div>     
	</body>
</html>

四、配置安装方式

SDK 集成完成后,按照sharetrace控制台接入流程完成后续的配置。