Simple and easy logging in Swift.
- Super simple. Only one method to log.
- Rolled logs.
- Simple concise codebase at just at barely two hundred LOC.
First thing is to import the framework. See the Installation instructions on how to add the framework to your project.
//iOS
import SwiftLogSwiftLog can be used right out of the box with no configuration, simply call the logging function.
logw("write to the log!")That will create a log file in the proper directory on both OS X and iOS.
OS X log files will be created in the OS X log directory (found under: /Library/Logs). The iOS log files will be created in your apps document directory under a folder called Logs.
There are a few configurable options in SwiftLog.
//This writes to the log
logw("write to the log!")
//Set the name of the log files
Log.logger.name = "test" //default is "logwile"
//Set the max size of each log file. Value is in KB
Log.logger.maxFileSize = 2048 //default is 1024
//Set the max number of logs files that will be kept
Log.logger.name = 8 //default is 4
//Set the directory in which the logs files will be written
Log.logger.directory = "/Library/somefolder" //default is the standard logging directory for each platform.Check out Get Started tab on cocoapods.org.
To use SwiftLog in your project add the following 'Podfile' to your project
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
pod 'SwiftLog', '~> 0.9.1'
Then run:
pod install
Check out the Carthage docs on how to add a install. The SwiftLog framework is already setup with shared schemes.
First see the installation docs for how to install Rogue.
To install SwiftLog run the command below in the directory you created the rogue file.
rogue add https://github.com/daltoniam/SwiftLog
Next open the libs folder and add the SwiftLog.xcodeproj to your Xcode project. Once that is complete, in your "Build Phases" add the SwiftLog.framework to your "Link Binary with Libraries" phase. Make sure to add the libs folder to your .gitignore file.
Simply grab the framework (either via git submodule or another package manager).
Add the SwiftLog.xcodeproj to your Xcode project. Once that is complete, in your "Build Phases" add the SwiftLog.framework to your "Link Binary with Libraries" phase.
If you are running this in an OSX app or on a physical iOS device you will need to make sure you add the SwiftLog.framework or SwiftLogOSX.framework to be included in your app bundle. To do this, in Xcode, navigate to the target configuration window by clicking on the blue project icon, and selecting the application target under the "Targets" heading in the sidebar. In the tab bar at the top of that window, open the "Build Phases" panel. Expand the "Link Binary with Libraries" group, and add SwiftLog.framework or SwiftLogOSX.framework depending on if you are building an iOS or OSX app. Click on the + button at the top left of the panel and select "New Copy Files Phase". Rename this new phase to "Copy Frameworks", set the "Destination" to "Frameworks", and add SwiftLog.framework or SwiftLogOSX.framework respectively.
- Complete Docs
- Add Unit Tests
SwiftLog is licensed under the MIT License.