Jetpack 又双叒一新成员 DragAndDrop 框架：大大简化拖放手势开发

Posted 2022-01-15 小陈乱敲代码

外网原文：Simplifying drag and drop
翻译：TechMerger

对于拖放手势，大家并不陌生，这是在桌面端最稀松平常的操作，比如将文件拖入回收站。随着移动设备的大屏趋势、可折叠设备的愈加发完善，拖放操作在移动平台里端也显得愈加必要和流行！

实现拖放手势： android 平台现存的方案略为复杂。基于此， Jetpack 框架集合里推出了新成员 DragAndDrop 。

本文着重阐述该框架的愿景和核心要点，主要内容译自 Android 开发者关系工程师 Paul 在 Meduim 上的*

本质来说，拖放手势（drag and drop）指的是用户通过点击选择图片、文本或者其他数据元素，然后直接拖放到 App 的其他界面、甚至其他 App 的界面，接着这个数据就被纳入到新的界面内。这个手势通常表现为在触摸屏上的长按拖动或者非触摸屏上的单击并用鼠标拖动，最后在目标位置放下。

来看一个 App 内典型的拖放效果：

尽管 Android 一直长期支持拖放手势的实现（比如早在 Android 3.0 即加入的 DragEvent API），但事实证明：想要完整、顺畅地实现针对过程中的手势、触摸事件、权限以及回调的集成，往往比较困难和复杂。

现在我想向大家推荐 Jetpack 的新成员 DragAnd Drop 框架，目前处于 alpha 版本，其旨在辅助你更加简单地处理拖放 App 内的数据。

在 build.gradle 里引入依赖，即可使用。

implementation 'androidx.draganddrop:draganddrop:1.0.0-alpha02'

拖放手势的使用在大屏设备上日益频繁，比如平板电脑和笔记本电脑，尤其是可折叠设备。在这种类型的设备上进行分屏的操作比传统的智能手机多了高达 7 倍。他们的用户常常需要使用分屏或多窗口模式来处理多任务的场景，而将数据在不同的 App 间拖放是再自然不过的体验和需求！

Android 平台原生已经支持从输入框控件 EditText 拖动文本，但我们强烈建议开发者实现用户从其他控件拖动数据的手势，支持的数据类型除了文本以外，还能包括图片、文件等任意类型。当然了，反向支持数据从其他 App 拖放进来也同等重要，并值得鼓励。

来看一个 App 之间拖放文本和图片的示例效果：

DragStartHelper，结合 DropHelper 构成了整个框架最核心的 API，它们可以轻松实现手势支持、数据的回调、样式和像素级的 UI 对齐等实现环节。

DragStartHelper

作为 Jetpack 框架集合 core 包下的工具类， DragStartHelper 负责监测拖动手势的开始时机。这些手势包括长按拖动、单击并用鼠标拖动等。

使用起来很简单，将需要监听的视图包装进来并开始监听。框架会在拖动手势触发的时候回调过来，之后进行一些简单的配置即可。

1. 将需要传递的数据包装到 ClipData 中
2. 新建用于展示拖动效果的图片实例 DragShadowBuilder
3. 将数据和拖动效果外加一些 Flag 交由 View 的原生方法 startDragAndDrop() 进行后续的动作，包括效果的展示和数据的传递等

// Make a view draggable to share a file. DragStartHelper takes care of
// intercepting drag gestures and attaching the listener.
DragStartHelper(draggableView)  view, _ ->
    // Sets the appropriate MIME types automatically.
    val dragClipData = ClipData.newUri(contentResolver, "File", fileUri)

    // Set the visual look of the dragged object.
    // Can be extended and customized; we use the default here.
    val dragShadow = View.DragShadowBuilder(view)

    // Starts the drag. Note that the global flag allows for cross-app dragging.
    view.startDragAndDrop(
        dragClipData,
        dragShadow,
        null, // Optional extra local state information
        // Since this is a "content:" URI and not just plain text, we can use the
        // DRAG_FLAG_GLOBAL_URI_READ to allow other apps to read from our content
        // provider. Without it, other apps won't receive the drag events.
        DRAG_FLAG_GLOBAL or DRAG_FLAG_GLOBAL_URI_READ)
    )
.attach()

DropHelper

另一个核心工具类 DropHelper，则关心拖动数据放下的时机和目标视图。

适配的代码简单来讲：

1. 需要针对可拖放数据的试图调用 configureView 方法
2. 其内部还需要设定关心的数据类型即 Mime Type
3. 指定一些其他可选参数实例 DropHelper.Options，比如放下时高亮的颜色和视图范围等
4. 最后设置最重要的放下监听器 OnReceiveContentListener，去从 ClipData 中取得数据执行上传、显示等处理，当然还包括不匹配的警告或视图提醒等

注意：构建 DropHelper.Options 实例的时候，记得调用 addInnerEditTexts()，这样可以确保嵌套的 EditText 控件不会抢夺视图焦点。

DropHelper.configureView(
    // Activity that will handle the drop
    this,
    // Target drop view to be highlighted
    outerDropTarget,
    // Supported MIME types
    arrayOf(MIMETYPE_TEXT_PLAIN, "image/*"),
    // Options for configuring drop targets
    DropHelper.Options.Builder()
        // To ensure proper drop target highlighting, all EditText elements in
        // the drop target view hierarchy must be included in a call to this
        // method. Otherwise, an EditText within the target, rather than the
        // target view itself, acquires focus during the drag and drop operation.
        .addInnerEditTexts(innerEditText)
        .build()
)  _, payload ->
  // Process the payload here, returning any content that should be delegated to
  // the platform.
  ...

以下Android Jetpack完全手册PDF电子书版已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码【免费获取】

Jetpack Compose从入门到精通

接下来给大家介绍一份2021年最新整理出来的《Jetpack Compose 完全开发手册》，手把手教大家Jetpack Compose从入门到精通。

这份资料旨在给希望了解、学习、应用Android Jetpack Compose的小伙伴一个参考资料。

资料详情

第一章 初识 Jetpack Compose

• 为什么我们需要一个新的UI 工具？

• Jetpack Compose的着重点
  加速开发
  强大的UI工具
  直观的Kotlin API
  

• API 设计
  

1. Compose API 的原则
   一切都是函数
   顶层函数（Top-level function）
   组合优于继承
   信任单一来源
   

• 深入了解Compose
  Core
  Foundation
  Material
  

• 插槽API

第二章 Jetpack Compose构建Android UI

• Android Jetpack Compose 最全上手指南
  Jetpack Compose 环境准备和Hello World
  布局
  使用Material design 设计
  Compose 布局实时预览
  ……
  

• 深入详解 Jetpack Compose | 优化 UI 构建
  Compose 所解决的问题
  Composable 函数剖析
  声明式 UI
  组合 vs 继承
  封装
  重组
  ……
  

• 深入详解 Jetpack Compose | 实现原理
  @Composable 注解意味着什么？
  执行模式
  Positional Memoization (位置记忆化)
  存储参数
  重组
  ……
  

第三章 Jetpack Compose 项目实战演练（附Demo）

• Jetpack Compose应用1
  开始前的准备
  创建DEMO
  遇到的问题
  
• Jetpack Compose应用2
• Jetpack Compose应用做一个倒计时器
  数据结构
  倒计时功能
  状态模式
  Compose 布局
  绘制时钟
  
• 用Jetpack Compose写一个玩安卓App
  准备工作
  引入依赖
  新建 Activity
  创建 Compose
  PlayTheme
  画页面
  底部导航栏
  管理状态
  添加页面
  
• 用Compose Android 写一个天气应用
  开篇
  画页面
  画背景
  画内容
  ……
  
• 用Compose快速打造一个“电影App”
  成品
  实现方案
  实战
  不足
  ……
  
  以上Android Jetpack完全手册PDF电子书版已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码【免费获取】

文末

其实成为一名优秀的程序员并不难。

但是怎样才能成为一名优秀的程序员？

我认为最大的阻碍在于：广度与深度难以兼顾。

计算机专业基础课，如OS，数据库，网络，算法等，抽象且难以理解，大学时不学，以后就很难拾起来。

既强调动手，又强调抽象，二者缺一不可。但善于思考的人，往往喜欢谋定而后动；善于行动的人，往往没功夫回顾思考。

对于要先理解才动手的人，是种折磨。往往做了一两年，才突然理解某个概念。

对于初学者，难以区分学的知识，还是配置。

杂讯太多，不知道学什么。

总得来说，编程里最简单的地方往往价值不高，困难的地方这次避开了，下次还是要理解，逃也逃不掉。