纵有疾风起
人生不言弃

手把手教你实现macOS应用文件拖拽进窗口功能-批量生成APP的多尺寸icon实战

本文始发于我的博文手把手教你实现macOS应用文件拖拽进窗口功能-批量生成APP的多尺寸icon实战,现转发至此。

目录

  • 前言
  • 拖拽功能
    • Source 、 Destination 和 Dragging Session
    • 需要处理的事情
  • Demo 功能实现
    • 功能拆解
    • 实现
    • 文件的读写权限
    • NSView 设置问题
    • 关于 Retina 设备生成图片大小问题
  • 总结

前言

最近公司项目的 APP 更换 icon,UI 设计师提供的素材缺少几个尺寸,因为不清楚具体需要哪些尺寸,且经过交流发现,UI 设计师生成不同尺寸时,是一个一个生成的,这样效率比较低,于是想做个小工具提高下这种工作的效率,当作玩玩 macOS 开发咯(之前开发过对接 jira 的批量新建分配任务的小工具且一直在使用)。

关于批量生成 icon 的,朋友推荐了一个在线工具,这个功能已经比较完善,可以了解下。当然,自己开发的话可以定制。

拖拽功能

讲讲拖拽那点事,更多具体信息可以看?的官方文档。

苹果官方文档 Drag and Drop

Source 、 Destination 和 Dragging Session

操作拖拽,那么就涉及到三个元素,拖拽的起点,称为源 Source;拖拽的终点,称为目的地 Destination;拖拽的对象,称为 Item 吧。源对应协议 NSDraggingSource,目的地对应协议 NSDraggingDestination;拖拽过程就是一个 Dragging Session;拖拽的对象是 NSDraggingItem,放在 NSPasteboard 中。

大概过程:

  1. 从 Source 开始拖拽,Dragging Session 生成并进行
  2. 选择拖拽对象,生成拖拽信息,拖拽的数据会存在拖拽粘贴板上
  3. 拖拽放到 Destination,接收到拖拽信息,可以选择拒绝或接收,并进行一些操作
  4. Dragging Session 结束

需要处理的事情

操作拖拽的 NSView 需要实现 NSDraggingSource 协议,拖拽的目的地 NSView 需要实现 NSDraggingDestination 协议。另外可以通过 NSView 的拖拽相关 Extension 去注册支持拖拽的类型 NSPasteboard.PasteboardType。目前支持的类型有几种图片类型、字体、颜色、URL、fileURL 等。拖拽之后,从 NSDraggingInfo 中获取相关信息进行处理。

协议具体需要实现的方法比较简单,没有什么特别要讲的。

NSDraggingSource

func draggingSession(_ session: NSDraggingSession, sourceOperationMaskFor context: NSDraggingContext) -> NSDragOperationoptional func draggingSession(_ session: NSDraggingSession, willBeginAt screenPoint: NSPoint)optional func draggingSession(_ session: NSDraggingSession, movedTo screenPoint: NSPoint)optional func draggingSession(_ session: NSDraggingSession, endedAt screenPoint: NSPoint, operation: NSDragOperation)optional func ignoreModifierKeys(for session: NSDraggingSession) -> Bool

NSDraggingDestination

optional func draggingEntered(_ sender: NSDraggingInfo) -> NSDragOperationoptional func draggingUpdated(_ sender: NSDraggingInfo) -> NSDragOperationoptional func draggingExited(_ sender: NSDraggingInfo?)optional func prepareForDragOperation(_ sender: NSDraggingInfo) -> Booloptional func performDragOperation(_ sender: NSDraggingInfo) -> Booloptional func concludeDragOperation(_ sender: NSDraggingInfo?)optional func draggingEnded(_ sender: NSDraggingInfo)optional func wantsPeriodicDraggingUpdates() -> Booloptional func updateDraggingItemsForDrag(_ sender: NSDraggingInfo?)

NSView 拖拽相关的 Extension

open func beginDraggingSession(with items: [NSDraggingItem], event: NSEvent, source: NSDraggingSource) -> NSDraggingSessionopen var registeredDraggedTypes: [NSPasteboard.PasteboardType] { get }open func registerForDraggedTypes(_ newTypes: [NSPasteboard.PasteboardType])open func unregisterDraggedTypes()

Demo 功能实现

简单实现下功能。本文 Demo 详见文章末尾的链接。

手把手教你实现macOS应用文件拖拽进窗口功能-批量生成APP的多尺寸icon实战插图
readme.gif

功能拆解

  1. 需求
  • 基于提供的大尺寸图片,批量生成不同尺寸的 icon

好吧,需求总是简单一句话描述,大概所有程序猿都讨厌产品经理这么说哈哈。

  1. 设想用户操作
  • 设计生成 icon 大尺寸图片
  • 支持拖拽来指定该文件为生成的基准
  • 勾选需要的尺寸
  • 指定生成目录

实现

拖拽是从别的文件夹窗口拖拽过来的,所以不需要定义一个 NSView 去实现 NSDraggingSource 协议。

下面定义 DestinationView,NSView 类型,实现 NSDraggingDestination 协议。因为 NSView 默认扩展了该协议,所以不需要声明扩展。

定义 Delegate 代理,DestinationViewDelegate,通知外部。

protocol DestinationViewDelegate {  func processImage(_ image: NSImage)}

awakeFromNib 中注册支持的类型 NSPasteboard.PasteboardType.fileURL

registerForDraggedTypes([NSPasteboard.PasteboardType.fileURL])

然后实现 NSDraggingDestination 协议几个方法

draggingEntered 需要判断拖拽的内容是否接收,本 Demo 没有处理。

override func draggingEntered(_ sender: NSDraggingInfo) -> NSDragOperation {    return .copy}

可以进行以下处理:

let pasteBoard = sender.draggingPasteboardlet accept = NSImage(pasteboard: pasteBoard) != nilreturn accept ? .copy : NSDragOperation()

The data represented by the image can be copied. 返回 .copy 是为了后面展示图片;

具体参考 NSDragoperation

draggingExited,当拖拽退出时,需要设置 needsDisplay 为 true。

needsDisplay,NSView 用于确定在显示之前是否需要重绘视图。

performDragOperation,判断是否图片,并处理。

下面是 DestinationView 完整的代码。

//  DestinationView.swiftimport Cocoaprotocol DestinationViewDelegate {  func processImage(_ image: NSImage)}class DestinationView: NSView {  var delegate: DestinationViewDelegate?  override func awakeFromNib() {      registerForDraggedTypes([NSPasteboard.PasteboardType.fileURL])  }  var isReceivingDrag = false {      didSet {          needsDisplay = true      }  }  override func draggingEntered(_ sender: NSDraggingInfo) -> NSDragOperation {      return .copy  }  override func draggingExited(_ sender: NSDraggingInfo?) {      isReceivingDrag = false  }  override func prepareForDragOperation(_ sender: NSDraggingInfo) -> Bool {      return true  }  override func performDragOperation(_ sender: NSDraggingInfo) -> Bool {      isReceivingDrag = false      let pasteBoard = sender.draggingPasteboard      guard let image = NSImage(pasteboard: pasteBoard) else {          return false      }      delegate?.processImage(image)      return true  }}

文件的读写权限

macOS开发,文件相关的组件有两个 NSOpenPanel 和 NSSavePanel。前者用于选择文件或者文件夹,后者用于保存单个文件。因为需要批量保存,NSSavePanel 无法实现,所以使用 Data 的 write 方法。

public func write(to url: URL, options: Data.WritingOptions = []) throws

文件读写,需要修改对应 Target 的 Capabilities 中的 App Sanbox – File Access 权限。

User Selected File 修改为 Read/Write 即可读写。

也可以关闭 App Sanbox 。

try? imageData?.write(to: path.appendingPathComponent("icon\(iconSize.rawValue).png"))

发布到 Mac AppStore 的应用,必须遵守沙盒约定。macOS APP 不需要上架,可以不开启 Sandbox 功能,随意访问 mac 上的文件。

NSView 设置问题

NSView 没有 backgroundColor 属性,修改背景色需要修改 layer 的。

backgroundView.layer?.backgroundColor = NSColor.white.cgColor

并且需要设置 wantsLayer 生效。

backgroundView.wantsLayer = true

包括设置圆角,也需要设置 wantsLayer。

backgroundView.layer?.cornerRadius = 10

关于 Retina 设备生成图片大小问题

public convenience init(size: NSSize, flipped drawingHandlerShouldBeCalledWithFlippedContext: Bool, drawingHandler: @escaping (NSRect) -> Bool)

在 Retina 设备上,NSImage 的初始化方法传递参数 size ,生成的图片的尺寸会是 size 的两倍。不了解,暂时先除以 2 解决。后面找到原因再处理下,如果了解原因欢迎给我留言哈。

总结

没什么好总结的哈哈。

本文Demo:https://github.com/sapphirezzz/AppIconReducer

-END-
欢迎到我的博客交流:https://zackzheng.info

文章转载于:https://www.jianshu.com/p/53274bee4a64

原著是一个有趣的人,若有侵权,请通知删除

未经允许不得转载:起风网 » 手把手教你实现macOS应用文件拖拽进窗口功能-批量生成APP的多尺寸icon实战
分享到: 生成海报

评论 抢沙发

评论前必须登录!

立即登录