神马笔记共享功能·开篇

神马笔记共享功能·开篇

一、简介

神马笔记在版本1.2.0时加入了共享功能。

支持将笔记内容复制到粘贴板,保存为文件,发送到第三方应用。

整个过程大概经历了以下几个步骤。

  1. 编写静态界面(编辑及共享)
  2. 编写弹出对话框(笔记、编辑及共享)
  3. 实现复制到粘贴板
  4. 实现保存为图片
  5. 实现发送到第三方应用
  6. 实现保存为文本
  7. 实现保存为Markdown及预览

二、编写界面

  • 静态界面

首先在笔记编辑界面右上角增加了”共享“按钮,点击后弹出”共享“及”复制文字内容“对话框。

其次增加了共享笔记界面。

为什么需要一个新的共享界面,而不是直接在编辑界面进行分享?

因为需要保存图片

编辑界面的RecyclerView高度为match_parent,因此不能完整呈现笔记内容。

共享界面的RecyclerView高度为wrap_content,显示的是所有笔记内容。

另外一种处理方式是在编辑界面创建离屏的wrap_content的RecyclerView,但是因为图片采用的是异步加载的方式,需要等待图片加载完毕才能进行保存。与增加共享界面比较起来,新加一个界面,实现更为简单。

此外,在后续版本中,共享时会增加一个笔名的信息。在共享界面可以更好显示笔名。

  • 弹出对话框

  1. 笔记界面弹出菜单新增了“共享”菜单
  2. 编辑界面新增弹出对话框“共享”及“复制文字内容”
  3. 共享界面弹出对话框选择共享方式,第一栏为神马笔记功能,第二栏为发送到第三方应用。

三、定义分享的类结构

  • BaseShareAction 分享基类,定义分享必须的属性,及接口
    • ShareClipboardAction 复制到粘贴板
    • BaseShareFileAction 保存为文件
      • ShareTextAction 保存为文本
      • SharePictureAction 保存为图片
        • ShareIntentAction 发送到第三方应用
      • ShareMarkdownAction 保存为Markdown
        • ShareHexoAction 保存为Hexo Markdown

四、需要处理的技术问题

1. 获取处理Intent列表

通过Intent可以调用第三方应用,但是无法控制排列顺序。

因此,我们需要手动获取Intent列表,并进行处理。

2. 粘贴板Clipboard

最容易处理的技术问题,参考TextView的paste方法实现,即可完成复制到粘贴板功能。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
private void paste(int min, int max, boolean withFormatting) {
ClipboardManager clipboard =
(ClipboardManager) getContext().getSystemService(Context.CLIPBOARD_SERVICE);
ClipData clip = clipboard.getPrimaryClip();
if (clip != null) {
boolean didFirst = false;
for (int i = 0; i < clip.getItemCount(); i++) {
final CharSequence paste;
if (withFormatting) {
paste = clip.getItemAt(i).coerceToStyledText(getContext());
} else {
// Get an item as text and remove all spans by toString().
final CharSequence text = clip.getItemAt(i).coerceToText(getContext());
paste = (text instanceof Spanned) ? text.toString() : text;
}
if (paste != null) {
if (!didFirst) {
Selection.setSelection(mSpannable, max);
((Editable) mText).replace(min, max, paste);
didFirst = true;
} else {
((Editable) mText).insert(getSelectionEnd(), "\n");
((Editable) mText).insert(getSelectionEnd(), paste);
}
}
}
sLastCutCopyOrTextChangedTime = 0;
}
}

3. 运行时权限

当将笔记保存到外部文件,图片、文本、Markdown时,需要动态申请WRITE_EXTERNAL_STORAGE权限,否则在Android6.0之后,无法写入外部文件。

BaseShareFileAction便是为动态申请权限而设计的,首先会动态申请权限,申请成功后才会继续后续的任务。

完成权限申请工作,则是通过RxPermissions实现的。

GitHub项目地址:

  • https://github.com/tbruyelle/RxPermissions

4. 异步操作

读写文件为耗时操作,为了避免ANR,IO操作必须实现为异步。

这里使用RxJava + RxAndroid来完成。

GitHub项目地址:

  • https://github.com/ReactiveX/RxJava

  • https://github.com/ReactiveX/RxAndroid

Wiki帮助手册:

  • https://github.com/ReactiveX/RxJava/wiki

  • https://github.com/ReactiveX/RxJava/wiki

5. 保存图片到图库

保存图片分为3个步骤

  1. 将View转换为Bitmap
  2. 保存Bitmap
  3. 更新图库信息

6. 处理Markdown

支持图文混排的标准格式有很多,如Markdown,Html,Pdf,Word,……

其中以Markdown最为简单,因此首先支持Markdown格式。

关键是将图片转换为markdown语法,并且导出图片文件。

但是,与图片和文本有内置应用可以直接查看不同,手机上通常不会内置markdown的阅读器。

因此,需要将markdown转化为html格式,以通过浏览器查看。

从Android7.0开始,通过Intent调用第三方应用,不允许传递file://的Uri,否则将抛出运行时异常FileUriExposedException。

通过content:://形式Uri调用第三方应用存在的一个问题是:html中的图片无法显示。

无论采用绝对路径或者相对路径均无法显示。

唯一的办法是将图片保存到服务端,以http的方式来显示。

经过测试,图片采用绝对路径file://形式:

Chrome、Smartisan OS内置浏览器无法显示图片;

UC浏览器、MIUI内置浏览器可以显示图片。

五、规范化命名

无法什么时候,命名都是个头疼的问题。

常见的的几种命名方式:

  1. UUID,通用唯一识别码
  2. ID,唯一编号
  3. Time,当前时间
  4. 笔记名称

前3种方式可以保证文件名的唯一性,但是可读性非常差,用户基本无法找到导出的文件。

第4种方式无法保证文件名的唯一性,但是是可读的,用户友好的。

考虑导出文件临时性,并不过于要求唯一性,因此采用笔记名称的方式。

同时,遇到同名文件时,是覆盖,还是连续编号?

采用覆盖的方式,因为导出文件的临时性,连续编号会产生额外的文件,对用户并没有意义。

六、体验地址

神马笔记最新版本:【神马笔记 版本1.2.0.apk