uni-app接入

一、导入App原生插件

ShareTrace SDK采用原生方式进行开发, 所以使用的时候要先按照uniapp原生插件的使用方式导入插件。 原生插件的使用方式可参考官方教程。

插件导入后,需要配置Sharetrace appkey,appKey 可在sharetrace官网中获得,创建App 成功后即可获得 appKey。

如果开启了独立IP服务,还需要配置sharetrace server,分配的域名可在sharetrace官网中查询,如果未开启独立IP,请置空该参数,不要配置。

二、调用ShareTrace API

获取安装携带的参数

在需要获取安装参数的页面调用 ShareTrace API 的 getInstallTrace方法,一般建议放在onReady中调用。 示例代码:

<template>
    ...
</template>

<script>
    const sharetrace = uni.requireNativePlugin('shoot-sharetrace');

    export default {
        ...,
        onReady() {
            sharetrace.getInstallTrace( data => {
                this.showResult(JSON.stringify(data));
            });
        },
        methods: {
            showResult(data) {
                uni.showModal({
                    title: 'ShareTrace',
                    content: data,
                    showCancel:false,
                    success: function (res) {

                    }
                });
            }
        }
    }
</script>

一键调起

建议在onLaunch中注册调起参数回调,如下所示:

<script>
    var sharetrace = uni.requireNativePlugin("shoot-sharetrace")
    export default {
        onLaunch: function() {
            console.log('App Launch')
            sharetrace.registerWakeupTrace( data => {
                if (data) {
                    console.log('registerWakeupTrace callback' + JSON.stringify(data))
                    uni.showToast({
                        title: JSON.stringify(data),
                        icon: "none",
                        duration: 3000
                    })
                }
            });
        },
        onShow: function() {
            console.log('App Show')
        },
        onHide: function() {
            console.log('App Hide')
        }
    }
</script>

三、完成配置

SDK集成完成后,需要按照sharetrace官网的 Android/iOS 配置指引完成安装方式的配置才能获取到参数。(以Android为例,iOS类似)

SDK集成

使用的第三方平台SDK可以直接点击我已集成下一步

配置安装方式

根据自己实际需求选择相应的安装方式,如果应用还没有发布,可以选择暂不配置,该配置仅适用于开发测试,在上线前一定要记得修改。

四、一键调起

Sharetrace支持通过标准的Scheme和Universal Links(iOS>=9),接入Sharetrace SDK后,在各种浏览器,包括微信,微博等内置浏览器一键调起app,并传递网页配置等自定义动态参数。配置只需简单几个步骤即可,如下:

4.1 开启一键调起功能

登录Sharetrace的管理后台,找到iOS配置,开启相关功能和填入配置 5_apple_config_on.png

其中Team Id可以在Apple开发者后台查看

同理,找到Android配置,开启相关功能。

4.2 开启Associated Domains服务

登录到Apple管理后台,在Identifiers找到所需开启到App ID

5_apple_dev_config.png

注:开启Associated Domains服务后需要重新生成profile文件并下载保存本地,后续在提交云端打包时需要使用.

4.3 Scheme配置

在HBuilderX中打开项目,找到mainfest.json中的App常用其它配置,分别在Android和iOS中UrlScheme填入Sharetrace后台获取到到Scheme

4.4 Universal Link配置(iOS)

以源码方式打开manifest.json, 参考以下配置:

"app-plus" : {
        ...

        /* 应用发布信息 */
        "distribute" : {
            /* android打包配置 */
            "android" : {
                ...
            },
            /* ios打包配置 */
            "ios" : {
                "urltypes" : "yourScheme",
                // 注:主要是增加 capabilities 这个配置!
                "capabilities" : {
                    "entitlements" : {
                        "com.apple.developer.associated-domains" : [ "applinks:xxxxxx.stul.sharetrace.com" ]
                    }
                }
            }
        }

五、配置安装方式

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

results matching ""

    No results matching ""