KZFileWatchers
Wouldn't it be great if we could adjust feeds and configurations of our native apps without having to sit back to Xcode, change code, recompile and navigate back to screen we were at?
One of the basis of building tools that allow us to do just that is the way we observe for data changes, this micro-framework provides you File observers for Local and Remote assets.
This framework provides:
-
FileWatcher.Localuseful for observing local file changes, it can also be used to breach Sandbox env for debug simulator builds and e.g. observe file on the developer desktop (like the demo app does). -
FileWatcher.Remotecan be used to observe files on the web, it supports bothEtagheaders andLast-Modified-Dateso you can just put file on Dropbox or real ftp server.
It also supports usage from Objective-C projects. For this, you should consider these following steps:
-
Add
$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)into your projects Library Search Paths in Build Setting section. -
Import swift-header by adding
@import KZFileWatchers;into any.mfile, where you want to use FileWatchers. -
Use provided classes for set up file observing like this:
self.fileWatcher = [[LocalFileWatcher alloc] initWithPath:path];
self.fileWatcher.delegate = self;
[self.fileWatcher startWithError:nil];
- Implement
FileWatcherDelegatein your class for handling file refreshing events. For example:
- (void)refreshDidOccurFrom:(id<FileWatcherProtocol>)fileWatcher type:(enum RefreshResult)type data:(NSData *)data
{
self.textLabel.text = [[NSString alloc] initWithData:data encoding:kCFStringEncodingUTF8];
}
Installation
KZFileWatchers is available through CocoaPods and Swift Package Manager.
CocoaPods
In order to install KZFileWatchers by using CocoaPods, simply add the following line to your Podfile:
pod "KZFileWatchers"
Last version to support Swift 2.3 is 0.1.2 Last version to support Swift 3.0 is 1.0.4
Swift Package Manager
Installing KZFileWatchers over SwiftPM is only supported since version 1.0.1. You just need to add it as a dependency to your Package.swift manifest:
import PackageDescription
let package = Package(
name: "YourTarget",
dependencies: [
.Package(url: "https://github.com/krzysztofzablocki/KZFileWatchers.git", majorVersion: 1),
]
)
Author
Krzysztof Zabłocki, [email protected]
Contributing
Contributions to KZFileWatchers are welcomed and encouraged! Please see the Contributing guide.
A list of contributors is available through GitHub.
To give clarity of what is expected of our members, KZFileWatchers has adopted the code of conduct defined by the Contributor Covenant. This document is used across many open source communities. For more, see the Code of Conduct.
License
KZFileWatchers is available under the MIT license. See LICENSE for more information.
![[Question] KZFileWatchers Fatal Error, Xcode 8.2.1, Swift 3.0.2](https://avatars.githubusercontent.com/u/10137?v=4)
0 Nov 9, 2021
2.2k Jan 7, 2023
717 Dec 19, 2022
104 Nov 19, 2022
1.2k Dec 27, 2022
131 Jan 10, 2022
8 Oct 3, 2022
9 Sep 6, 2022
14 Sep 24, 2022
1.5k Dec 16, 2022
3 Aug 30, 2022
157 Dec 19, 2022
5.2k Jan 2, 2023
20 Dec 23, 2022
454 Dec 21, 2022
5.9k Dec 24, 2022
253 Dec 21, 2022
32 Dec 21, 2022
708 Jun 29, 2022