From 49364f4ea3350de020175fc06ed5b789a3a30044 Mon Sep 17 00:00:00 2001 From: Gennadiy Shafranovich Date: Wed, 4 May 2022 14:50:11 -0400 Subject: [PATCH] [SUH-4] Make package public (#5) Closes #4 --- LICENSE | 21 ++++ Package.resolved | 16 +++ Package.swift | 7 +- README.md | 212 ++++++++++++++++++++++++++++++++++- images/mocking-example-1.png | Bin 0 -> 63203 bytes images/usage-example-1.png | Bin 0 -> 63836 bytes 6 files changed, 248 insertions(+), 8 deletions(-) create mode 100644 LICENSE create mode 100644 Package.resolved create mode 100644 images/mocking-example-1.png create mode 100644 images/usage-example-1.png diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..37cf455 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2022 Twelve Products LLC + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/Package.resolved b/Package.resolved new file mode 100644 index 0000000..a918e2b --- /dev/null +++ b/Package.resolved @@ -0,0 +1,16 @@ +{ + "object": { + "pins": [ + { + "package": "SwiftFoundationExtensions", + "repositoryURL": "https://github.com/xiiagency/SwiftFoundationExtensions", + "state": { + "branch": null, + "revision": "7c821dc666239bcf956d5b91a2610db61d8b5fdf", + "version": "1.0.0" + } + } + ] + }, + "version": 1 +} diff --git a/Package.swift b/Package.swift index 4052cbb..090efa1 100644 --- a/Package.swift +++ b/Package.swift @@ -19,7 +19,7 @@ let package = .package( name: "SwiftFoundationExtensions", url: "https://github.com/xiiagency/SwiftFoundationExtensions", - .branchItem("main") + .upToNextMinor(from: "1.0.0") ), ], targets: [ @@ -29,10 +29,5 @@ let package = "SwiftFoundationExtensions" ] ), - // NOTE: Re-enable when tests are added. -// .testTarget( -// name: "SwiftUIHapticsTests", -// dependencies: ["SwiftUIHaptics"] -// ), ] ) diff --git a/README.md b/README.md index adf88c2..8f4b3dc 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,211 @@ -# SwiftUIHaptics +# SwiftUIHaptics Library -Provides a common service to use in projects that require haptics feedback. +[![GitHub](https://img.shields.io/github/license/xiiagency/SwiftUIHaptics?style=for-the-badge)](./LICENSE) + +An open source library that provides a common service to use in projects that require haptics feedback. + +Developed as re-usable components for various projects at +[XII's](https://github.com/xiiagency) iOS, macOS, and watchOS applications. + +## Installation + +### Swift Package Manager + +1. In Xcode, select File > Swift Packages > Add Package Dependency. +2. Follow the prompts using the URL for this repository +3. Select the `SwiftUIHaptics` library to add to your project + +## Dependencies + +- [xiiagency/SwiftFoundationExtensions](https://github.com/xiiagency/SwiftFoundationExtensions) + +## License + +See the [LICENSE](LICENSE) file. + +## Supported Platforms + +This library is compatible with the iOS, watchOS, and macOS platforms. On iOS/watchOS the haptics engine is used to play various haptic events. However, on macOS all events are simply skipped. MacOS support is provided simply to allow the same piece of SwiftUI code to interact with the haptics service, without having to "gate" its logic using an OS check. + +## Defining haptic events ([Source](Sources/SwiftUIHaptics/HapticEvent.swift)) + +```Swift +struct HapticEvent { + let underlyingEvents: [CHHapticEvent] +} +``` + +A struct containing a series of `CHHapticEvent`s to be played via the `HapticsService`. + +## Creating haptic events ([Source](Sources/SwiftUIHaptics/HapticEvent.swift)) + +### Single events + +```Swift +extension HapticEvent { + static func single( + intensity: Float? = nil, + sharpness: Float? = nil, + attack: Float? = nil, + decay: Float? = nil, + release: Float? = nil, + sustained: Float? = nil, + relativeTime: TimeInterval = 0.0, + duration: TimeInterval = 0.0 + ) -> HapticEvent +} +``` + +Creates a single `HapticEvent`, with the ability to specify all the parameters and defaulting others. + +### Patterns + +```Swift +extension HapticEvent { + static func pattern(events: [HapticEvent]) -> HapticEvent + + static func pattern(_ events: HapticEvent...) -> HapticEvent +} +``` + +Creates a pattern of haptic events by combining all underlying events for the provided `HapticEvent` instances. + +### From an existing `HapticEvent` + +``` Swift +extension HapticEvent { + func timeShifted( + relativeTime: TimeInterval, + duration: TimeInterval + ) -> HapticEvent +} +``` + +Returns a time shifted `HapticEvent` with the provided relative time and play duration specified. + +## `HapticsService` ([Source](Sources/SwiftUIHaptics/HapticsService.swift)) + +```Swift +class HapticsService : ObservableObject { + var isAvailable: Bool { get } + + init() + + func play(event: HapticEvent) { +} +``` + +## Usage Example + +### Define your events + +```Swift +extension HapticEvent { + static let strong: HapticEvent = + .single(intensity: 0.75, sharpness: 0.75, decay: -0.5) + + static let normal: HapticEvent = + .single(intensity: 0.5, sharpness: 0.5, decay: -0.5) + + static let ripPattern: HapticEvent = .pattern( + events: (0..<12).map { index in + HapticEvent.normal + .timeShifted( + relativeTime: Double(index) * 0.025, + duration: 0.1 + ) + } + ) +} +``` + +### Wire up the `HapticsService` + +```Swift +import SwiftUI +import SwiftUIHaptics + +@main +struct FooApplication : App { + @StateObject private var hapticsService = HapticsService() + + var body: some Scene { + WindowGroup { + ContentView() + .environmentObject(hapticsService) + } + } +} +``` + +### Fire events in your `View`s + +```Swift +struct ContentView : View { + @EnvironmentObject private var hapticsService: HapticsService + + var body: some View { + VStack { + Spacer() + + Button("Normal") { + hapticsService.play(event: .normal) + } + .buttonStyle(BorderedButtonStyle()) + .padding(20) + + Button("Strong") { + hapticsService.play(event: .strong) + } + .buttonStyle(BorderedButtonStyle()) + .padding(20) + + Button("Rip!!!") { + hapticsService.play(event: .ripPattern) + } + .buttonStyle(BorderedButtonStyle()) + .padding(20) + + Spacer() + } + } +} +``` + + + +### Supporting mocking + +Mocking of the service can be useful in previews as well as other applications. The `HapticsService` is shipped with mocking support that can be used in debug builds as follows: + +```Swift +#if DEBUG +struct ContentView_Previews : PreviewProvider { + static var previews: some View { + PreviewView() + } +} + +struct PreviewView : View { + @StateObject private var mockHapticsService = MockHapticsService() + + @State private var eventsPlayed: Int = 0 + + var body: some View { + VStack { + Text("# of events played: \(eventsPlayed)") + + ContentView() + .environmentObject(mockHapticsService as HapticsService) + } + .onAppear { + mockHapticsService.playCallback = { _ in + eventsPlayed += 1 + } + } + } +} +#endif +``` + + \ No newline at end of file diff --git a/images/mocking-example-1.png b/images/mocking-example-1.png new file mode 100644 index 0000000000000000000000000000000000000000..304f07e2ec6a72e3ffa977838d08d5e2d1daa18e GIT binary patch literal 63203 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 literal 0 HcmV?d00001 diff --git a/images/usage-example-1.png b/images/usage-example-1.png new file mode 100644 index 0000000000000000000000000000000000000000..56d6dea55380ae89acca000508050e14a9e95966 GIT binary patch literal 63836 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

rV4_u2fK-3xoe-;PdQPxK3?2E%jJ98?ey zc(*}mU!llWkfcCTwGepa?gba)U1yc%;Pei(Enof;Zhhcli?#8Y%*`;`&7xN-=(c^q zRWAn>8D!$!i0XfUav0-v8a*U6oqc~e5%Y@=GEVOmFWYsX?IEfww-6s$105?_tSk+6 z=u&_x#nI2mnPN32y@%YcN_<#7{b0==jCH8Q^J7ny5?bHY8o2NKo7(SWr}8<}-f@Rz z$wemuKC{(AJJyx+Cw?1_M5HXYI#9_%5l;}GE-ELvsb=2%Nhg+|Z)%{Gi-@>rcNFvi zSefDnaPu$Su4(Bblsu9 zeM^<#UmFbv^=%t@z>sa3yz0FQfV(A0BX+!3ZZv&OB9Yp}OL-ZpJo}1@Oev1Pd9Ed% zeVVjX5vkbXnl4whxi{m@4sRHCMg2TQ;M;AA>vCyzRd&z z>1g#JebNq*EW_bflw33Wl8cyAF+6%G;Ow4A8f9Jj`a{FC^&~{0rQYbK?1x(f4&?`( z7HtDN->#c`>g`{R*H$39vgi3HEUC}a1PtEPlYw<+It(nIv-@V{WiGDuHqH5C1xP0!E%cu{+;i+_@iP_NU%H z<%#9QBWOy4e4iTNhAYR>CyxCMNhIQaZ}GO#BtlG#6qrsulq=dzkIFX8xaD5xs;10Ws3 zs^(AZEdBfd&=UPW?*|fRI!#>`W~8G$;Mn+ig~}(8$+1KuC!aX!vF_Q0Z(ZUSt@@*n zG+f=^r?*&=r_z(p&t*?bo-P}n7G*CyIuxJb!+?<;eU+Ffd>dHTZK3V|#xdpl)o@nI zAI4@gG+fog&DBmEB-<3O_t}1vzWpaja|WI(Tj`C0?`@7JB)o0i3%ncPby{0v!twU4 zRZ#VEx@+~;?oz5F=|>DcV<>@K3(V;{vDGA_Lf)aE)Gec6={6;|@I8vW_0wi8B_YJDz(OSt~jI0c0}Wg0)@_5RuhY5i1%u8KHQmL zrF@vYAtheo%U??mcZ{@#5oN6|qfXPhY-nrM;cge}- z!qJUBS5Tl{Warfu5i?kit_d&W4X~XZqV0CEQnjVG&oZrDP0&V5$DGviVg`Sy?IINY z;K6d1V;$$8u_Y9cAl82lI8Figc_Q+{b-8at%6`>&V-AA3ViKYgUaWB7rD1SmVIxm! zBR8K-+cWem$vtwo($bCf>VUOX_%}&WBSBA2E7E|$>j1+BnUEu5YjpICfHZEeK9(B( z@ZzD-R(IIy6p+4#1Y+**2W|KIhTXw=mezzdmHBgDx_O(;=SIN=)^ha+%-wqr5{m|e zS?Qvt_NMlHFhJ^>LupXyTDRT`Uk$z`Y;{jR z1!NSEQ9wok83kk%kWoNJ0T~5k6p&FsMgbWGWE7B5Kt=%>1!NSEQ9wok83kk%kWoNJ z0T~5k6p&HyKOF@)0tPi+5-1!py<;q}eX2sTU-6FfV@4J$NToBBiPFJ&OXvgAIcH*m zJ9VN<=e|+JGv}PQzP`m3zYA^{cG+x)^Fs@KK8m`!kHQw$x60@DmmC>Gh{Hku)e!YR zeG|zmC3m*`hX%oapNvDcC1hJdR)havp+Hjmvy8JJ)zO+KKook7#pkWiV5R=i+rxiIw6;ufepFE%W+j~)&^3uf8D-GSfiO$}JwYS-@I$^heYHzzXHI2zP>xdv~z;%Gji$`U9j9Az~3W9 L_4|2$nZ5a6wP3+= literal 0 HcmV?d00001