WPS二次开发系列:WPS SDK初始化

作者持续关注WPS二次开发专题系列,持续为大家带来更多有价值的WPS开发技术细节,如果能够帮助到您,请帮忙来个一键三连,更多问题请联系我(QQ:250325397)

本文将详细介绍WPS SDK初始化,帮您能够更好的在项目中接入WPS SDK实现自己的应用和WPS应用进行通信交互。

1.集成前的准备

1.1申请集成资料:

向WPS官方发送邮件申请,邮件格式如下

邮件模板:
发起人 :有需要申请接入WPS移动端的企业或者个人
邮件主题: XXX公司XXX项目---WPS Android端 SDK二次开发集成申请
邮件发送: m_open_sdk@wps.cn
邮件内容
请明确包含申请项目背景规模、集成应用第三方APP包名、 具体需求 ******、******集成周期等

以上面格式发送邮件申请后,WPS方审核通过后会以邮件回复的相关集成资料(SDK&Demo&集成文档)

2.开始集成

2.1 环境配置

在自己项目工程中导入wps-sdk依赖库(wps_sdk.aar)

  • 将wps-sdk-xxx.aar 拷贝到项目中的libs目录下

  • 在项目build.gradle中添加

    dependencies {
    implementation fileTree(include: ['.jar', '.aar'], dir:'libs')//或者// implementation files("/libs/wps-sdk-xxx.aar")
    .....
    }

2.2 SDK初始化

在第三方应用Application中的onCreate方法中调用

调用 WpsSdk.getInstance().init(...)进行初始化

参考示例代码:

复制代码
public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        SdkConfig config = new SdkConfig.Builder()
                //开启日志开关
                .setEnableDebug(BuildConfig.DEBUG)
//                .setWpsPackageName("cn.wps.moffice_i18n_TV") //传入WPS的包名,比如需要调用TV版等,默认调用WPS版本不需要设置
                .build();
        //初始化
        WpsSdk.getInstance().init(this,  config, new ResultCallback() {
            @Override
            public void onCallback(Result result) {
                if (result.code == 0){
                    Toast.makeText(MyApplication.this, "WPS SDK初始成功", Toast.LENGTH_SHORT).show();
                }else {
                    Toast.makeText(MyApplication.this, "初始化失败:"+result, Toast.LENGTH_SHORT).show();
                }
            }
        });
    }
}

2.3 初始化注意事项说明

2.3.1 SDK初始化代码的调用位置?

  • SDK的初始化建议在自己应用MyApplication的onCreate方法中进行,如上文示例代码
  • 如果自己的是多进程架构的,需要注意SDK的初始化和后续SDK调用API保持同一个进程

2.3.2 SDK初始代码形式

2.3.2.1简单默认形式,默认使用WPS个人版
复制代码
public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        WpsSdk.getInstance().init(this);
    }
}
2.3.2.2 高级形式,SDK初始化时可以进行一些配置
复制代码
public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        SdkConfig config = new SdkConfig.Builder()
                //开启日志开关
                .setEnableDebug(BuildConfig.DEBUG)
//                .setWpsPackageName("cn.wps.moffice_i18n_TV") //传入WPS的包名,比如需要调用TV版等,默认调用WPS版本不需要设置
                .build();
        WpsSdk.getInstance().init(this,config);
    }
}

📌
PS: 注意可以通过setWpsPackageName来控制SDK打开的WPS版本,对于非应用市场通用的WPS版本,如WPS企业版,WPS TV版等版本,可以通过指定包名进行操作。

2.3.2.3 关注SDK初始返回值
  • 不关心初始化结果(返回值)

    • 默认配置

      WpsSdk.getInstance().init(this);

  • 自定义配置

    复制代码
        WpsSdk.getInstance().init(this,config);
  • 关心初始化结果(返回值),通过ResulCallback回调得到初始化结果Result

    //初始化
    WpsSdk.getInstance().init(this, config, new ResultCallback() {
    @Override
    public void onCallback(Result result) {
    if (result.code == 0){
    Toast.makeText(MyApplication.this, "WPS SDK初始成功", Toast.LENGTH_SHORT).show();
    }else {
    Toast.makeText(MyApplication.this, "初始化失败:"+result, Toast.LENGTH_SHORT).show();
    }
    }
    });

最后如果能够帮助到您,请动动发财的小手来个一键三连💪,老铁们有兴趣可以加Q群:250325397,吹牛摸鱼嗨起来!

相关推荐
Haven-15 分钟前
Java-面试八股文-JVM篇
java·jvm·面试
我真的是大笨蛋23 分钟前
JVM调优总结
java·jvm·数据库·redis·缓存·性能优化·系统架构
wjs04035 分钟前
Git常用的命令
java·git·gitlab
superlls1 小时前
(算法 哈希表)【LeetCode 349】两个数组的交集 思路笔记自留
java·数据结构·算法
田里的水稻1 小时前
C++_队列编码实例,从末端添加对象,同时把头部的对象剔除掉,中的队列长度为设置长度NUM_OBJ
java·c++·算法
ponnylv2 小时前
深入剖析Spring Boot启动流程
java·开发语言·spring boot·spring
前行的小黑炭2 小时前
Android 协程的使用:结合一个环境噪音检查功能的例子来玩玩
android·java·kotlin
揭老师高效办公2 小时前
在Word和WPS文字的表格中快速输入连续的星期、月、日
word·wps
阿华的代码王国2 小时前
【Android】内外部存储的读写
android·内外存储的读写
李少兄2 小时前
解决IntelliJ IDEA 提交代码时无复选框问题
java·ide·intellij-idea