本文始发于我的博文手把手教你实现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) -> NSDragOperation
optional 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) -> NSDragOperation
optional func draggingUpdated(_ sender: NSDraggingInfo) -> NSDragOperation
optional func draggingExited(_ sender: NSDraggingInfo?)
optional func prepareForDragOperation(_ sender: NSDraggingInfo) -> Bool
optional func performDragOperation(_ sender: NSDraggingInfo) -> Bool
optional func concludeDragOperation(_ sender: NSDraggingInfo?)
optional func draggingEnded(_ sender: NSDraggingInfo)
optional func wantsPeriodicDraggingUpdates() -> Bool
optional func updateDraggingItemsForDrag(_ sender: NSDraggingInfo?)

NSView 拖拽相关的 Extension

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

Demo 功能实现

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

readme.gif

功能拆解

1. 需求

• 基于提供的大尺寸图片，批量生成不同尺寸的 icon

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

2. 设想用户操作

• 设计生成 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.draggingPasteboard
let accept = NSImage(pasteboard: pasteBoard) != nil
return accept ? .copy : NSDragOperation()

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

具体参考 NSDragoperation。

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

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

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

下面是 DestinationView 完整的代码。

//  DestinationView.swift
import Cocoa

protocol 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