LNTouchVisualizer

iOS平台的触摸可视化框架。

GitHub release GitHub stars GitHub license PayPal Donation Button

GitHub issues GitHub contributors

添加到你的项目

Swift Package Manager

推荐使用 Swift Package Manager 来集成 LNTouchVisualizer 到你的项目。

LNTouchVisualizer 支持 SPM 5.1.0 及以上版本。要使用 SPM,你应该使用 Xcode 11 或更高版本打开你的项目。点击 File -> Swift Packages -> Add Package Dependency,输入 https://github.com/LeoNatan/LNTouchVisualizer。选择你想要使用的版本。

你也可以手动将 package 添加到你的 Package.swift 文件中

.package(url: "https://github.com/LeoNatan/LNTouchVisualizer.git", from: "1.0")

以及在你的 target 中添加依赖

.target(name: "BestExampleApp", dependencies: ["LNTouchVisualizer"]),

Carthage

将以下内容添加到你的 Cartfile 中

github "LeoNatan/LNTouchVisualizer"

请确保你遵循 Carthage 集成指南 这里

手动

LNTouchVisualizer.xcodeproj 工程拖到你的项目中,并且将 LNTouchVisualizer.framework 添加到你的项目 target 的 General 选项卡中的 Embedded Binaries。Xcode 应该会自动处理其他的事情。

CocoaPods

不支持 CocoaPods。有很多原因。请使用 Carthage 代替 CocoaPods。 你可以继续使用 CocoaPods 来管理其他的依赖,并且使用 Swift Package Manager 来管理 LNTouchVisualizer

使用框架

Swift

尽管框架是用 Objective C 编写的,但是它使用了现代 Objective C 语法,所以在 Swift 中使用该框架非常容易和直观。

项目集成

在你的项目中导入模块

import LNTouchVisualizer

触摸可视化

启用你的窗口场景的触摸可视化最简单的方法是在你的 scene delegate 中添加以下代码

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
	guard let scene = (scene as? UIWindowScene) else { return }
	scene.touchVisualizerEnabled = true
 
	//This is to configure the system touch visualizer window.
	let rippleConfig = LNTouchConfig.ripple
	rippleConfig.fillColor = .systemRed
	scene.touchVisualizerWindow.touchRippleConfig = rippleConfig
}

这将通过添加一个用于触摸可视化的透传窗口来启用你整个场景的触摸可视化,同时允许你使用自己的窗口作为你应用程序的 UI。

如果你想自己使用触摸可视化窗口,请查看 LNTouchVisualizerWindow.h 头文件以获取更多信息。

致谢

基于 COSTouchVisualizer