cordova-plugins-ths-email

基于第三方外包人员提供的 aar 进行二次开发的邮箱插件（aar 提供者，郭海洋，插件开发者 Mr. Liu） 2022.1.1新增发送邮件方法、修改初始化登录状态方法 2022.1.10新增获取缓存邮件个数方法、修改初始化登录状态方法，增加昵称字段

使用示例

1 登录邮箱服务，使用邮箱功能前此方法需要先调用

```js /

* 登录 邮件服务器，该方法在登录app的时候调用

* @param mUserName 邮箱系统的用户名

* @param mUserPassword 邮箱系统的密码

* @param mUserNick 昵称，中文名，用于显示在收发件人处

* @param mImapHost IMAP 服务地址

* @param mImapPort IMAP 端口

* @param mSmtpHost SMTP 主机地址

* @param mSmtpPort SMTP 端口

* @param mImapSsl IMAP是否支持SSL

* @param mSmtpSsl SMTP是否支持SSL

*/

(window as any).cordova.plugins.ThsEmail.tryLogin(mUserName,mUserPassword,mUserNick,mImapHost,mImapPort,mSmtpHost,mSmtpPort,mImapSsl,mSmtpSsl,(res) => { console.log(123); alert(res); },()=> { console.log(123); }); ```

2 初始化登录状态，再操作邮箱功能前调用该方法

```js / 初始化登录状态 @param {} emailsJsonStr 设置邮件列表，用于发送邮件时输入提示，例如：json 格式的字符串 {"email":"panfei@zhpt.hbj.bj","nickName":"潘飞"},{"email":"puzheng@zhpt.hbj.bj","nickName":"莆铮"} @param {} success @param {} error / (window as any).cordova.plugins.ThsEmail.initLogin( '{"email":"panfei@zhpt.hbj.bj"},{"email":"puzheng@zhpt.hbj.bj"}',(res) => { console.log(123); alert(res); },()=> { console.log(123); }); ```

3 跳转到消息列表页面

```js (window as any).cordova.plugins.ThsEmail.gotoMsgList( (res) => { console.log(123); alert(res); },()=> { console.log(123); }); ```

4 绑定未读消息监听

```js (window as any).cordova.plugins.ThsEmail.bindUnreadMsgListener( (res) => { console.log(123); alert(res); },()=> { console.log(123); }); ```

5 移除未读消息监听

```js (window as any).cordova.plugins.ThsEmail.removeMsgCountListener( (res) => { console.log(123); alert(res); },()=> { console.log(123); }); ```

6 发送邮件

```js / 跳转到发送邮件的界面 @param {} emailsJsonStr 设置收件人邮件列表，例如：json 格式的字符串 {"email":"panfei@zhpt.hbj.bj"},{"email":"puzheng@zhpt.hbj.bj"}，如果初始化登录数据的时候设置了昵称，此处也可以传递{"email":"潘飞"},{"email":"莆铮"} @param {} success @param {} error / (window as any).cordova.plugins.ThsEmail.gotoWrite( '{"email":"panfei@zhpt.hbj.bj"},{"email":"puzheng@zhpt.hbj.bj"}',(res) => { console.log(123); alert(res); },()=> { console.log(123); }); ```

7 监听未读邮件数量(注意不要重复监听，在页面移除时，移除监听，页面重新加载时重新监听)

```js document.addEventListener('ThsEmail.onMsgCountListenerInAndroidCallback', data => {

console.log(data);

alert(JSON.stringify(data));

}, false); ```

8 获取缓存未读邮件数量

```js (window as any).cordova.plugins.ThsEmail.getMsgCount( (res) => { console.log(123); alert(res); },()=> { console.log(123); }); ```

常见错误

1 The minCompileSdk (31) specified in a

dependency's AAR metadata (META-INF/com/android/build/gradle/aar-metadata.properties) is greater than this module's compileSdkVersion (android-30). Dependency: androidx.lifecycle:lifecycle-runtime:2.4.0. AAR metadata file: C:\Users\Administrator\.gradle\caches\transforms-3\e1b9a522463849a0cab234c5800addbc\transformed\lifecycle-runtime-2.4.0\META-INF\com\android\build\gradle\aar-metadata.properties. 分析：Android编译的版本与aar 中依赖的版本不一致 解决：根据错误信息位置路径修改版本为30，比如该错误文件C:\Users\Administrator\.gradle\caches\transforms-3\e1b9a522463849a0cab234c5800addbc\transformed\lifecycle-runtime-2.4.0\META-INF\com\android\build\gradle\aar-metadata.properties

2 > Task :app:processDebugMainManifest FAILED

D:\workspace\beijing\beijingju\mobileoa\code\android\app\src\main\AndroidManifest.xml:30:13-64 Error:

Attribute provider#androidx.core.content.FileProvider@authorities value=(io.ionic.starter.fileprovider) from AndroidManifest.xml:30:13-64

is also present at [:mail:] AndroidManifest.xml:21:13-60 value=(io.ionic.starter.provider).

Suggestion: add 'tools:replace="android:authorities"' to <provider> element at AndroidManifest.xml:28:9-36:20 to override.

D:\workspace\beijing\beijingju\mobileoa\code\android\app\src\main\AndroidManifest.xml:35:17-51 Error:

Attribute meta-data#android.support.FILE_PROVIDER_PATHS@resource value=(@xml/file_paths) from AndroidManifest.xml:35:17-51

is also present at [:mail:] AndroidManifest.xml:26:17-55 value=(@xml/provider_paths).

Suggestion: add 'tools:replace="android:resource"' to <meta-data> element at AndroidManifest.xml:33:13-35:64 to override.

分析： aar 中清单文件中存在于主应用存在冲突 解决：按照错误提示替换掉aar中配置 ```xml android:name="androidx.core.content.FileProvider"

android:authorities="${applicationId}.fileprovider"

tools:replace="android:authorities"

android:exported="false"

android:grantUriPermissions="true">

<meta-data

android:name="android.support.FILE_PROVIDER_PATHS"

android:resource="@xml/file_paths"

tools:replace="android:resource"

></meta-data>

</provider>

```