有道云笔记Anroid端SDK文档.PDF

有道云笔记Android 端SDK 文档 概述 本文主要描述YNOTE SDK 的开放的接口设计，目标读者为开发人员，测试人 员和架构师。 主要功能 从第三方发送笔记到有道云笔记 添加第三方应用的快捷启动到有道云笔记 从有道笔记启动注册的第三方应用 开发者注册 1. 注册账号 2. 添加APP 从而获取APP ID 应用名称 应用描述 应用下载市场连接 应用官方网站（可选） 水印图标 高清图标 应用签名 应用报名 3. 等待审核 - 可以开发调试，但是受限 4. 审核通过 API 使用指南 1.下载有道云笔记Android 端开发工具包 1 ）Ynote_sdk_sample 工程 样例工程 ，导出工程签名时需要使用工程中的签名文件（debug.keystore ）， 密码为android 2 ）Libynotesdk.jar 开发sdk 用到的包 3 ）YNoteSigFetcher.apk 取应用指纹工具 4 ）sdk 文档 2. 申请应用程序AppID 使用签名抽取工具（sigFetcher ）取得应用指纹信息（请确保应用的签名信 息正确 ），并到开发者应用程序登记页面进行App 注册取得AppId ，为了笔记的 跨平台处理 ，目前需要先注册OpenApi 3.使用sdk 提供的api [1]利用申请到的AppId 生成api 接口类 final IYNoteAPI api = YNoteAPIFactory.getYNoteAPI(this, AppId); [2]注册App 到有道云笔记 if(!api.isRegistered()){ api.registerApp(); } 注册成功的应用可以在有道云笔记更多笔记中展示 [3]保存笔记到有道云笔记 1 ）生成正文容器 YNoteContent mContent = new YNoteContent(); 2 ）为正文添加标题 mContent.setTitle(from sdk sample); 3 ）为正文添加文本、图片、及附件，保持添加顺序 mContent.addObject(new YNotePlainTextContent(txt)); mContent.addObject(new YNoteHtmlTextContent(txt)); 使用图片的绝对路径或者uri 来定位图片 mContent.addObject(new YNoteImageContent(uri)); or mContent.addObject(new YNoteImageContent(absPath)); or mContent.addObject(new YNoteImageContent(uri,absPath)); 使用附件的绝对路径或者uri 来定位附件 mContent.addObject(new YNoteAttachment (uri)); or mContent.addObject(new YNoteAttachment (absPath)); or mContent.addObject(new YNoteAttachment (uri,absPath)); or 4 ）生成发送笔记请求后设置笔记内容并发送 SendNoteRequest request = new SendNoteRequest(); request.setYNoteContent(mContent); api.sendRequest(request); [4]从有道云笔记启动第三方应用 1)只要成功注册到有道云笔记，就可以在更多笔记类型中展示应用的图标； 2)如果第三方实现了packagename.ynoteapi.YNoteEntryActivity 并在manifest 中设 activity 的export=true ，点击第三方应用图标时 ，笔记将调用这个页面 ，否则将 直接启动应用程序 ； 3)如果工程使用代码混淆并使用YNoteEntryActivity ，则需要保持 YNoteEntryActivity 不被混淆，在proguard.cfg 加上 -keep class packagename.