Added Theming

Author: David Seek

ChangelogKit.podspec

@@ -8,7 +8,7 @@
 
 Pod::Spec.new do |s|
   s.name             = 'ChangelogKit'
-  s.version          = '0.1.5'
+  s.version          = '0.1.6'
   s.summary          = 'A library that offers tools to display a changelog using webviews and user defaults.'
 
 # This description is used to generate tags and improve search results.

ChangelogKit/Classes/ChangelogKit.swift

@@ -17,18 +17,46 @@ private enum Constants {
     static let bannerText = "You are now using the latest update!"
 }
 
+public struct ChangelogKitTheme {
+    let navigationBarTintColor: UIColor// = .systemBlue
+    let backgroundColor: UIColor// = .white
+
+    public init(navigationBarTintColor: UIColor, backgroundColor: UIColor) {
+        self.navigationBarTintColor = navigationBarTintColor
+        self.backgroundColor = backgroundColor
+    }
+
+    public static var defaultTheme: ChangelogKitTheme {
+        if #available(iOS 13.0, *) {
+            return ChangelogKitTheme(
+                navigationBarTintColor: .systemBlue,
+                backgroundColor: .systemBackground)
+        } else {
+            return ChangelogKitTheme(
+                navigationBarTintColor: .systemBlue,
+                backgroundColor: .white)
+        }
+    }
+}
+
 public class ChangelogKit {
 
     private static let defaults = UserDefaults.standard
     private static let banner = BannerView(
         text: Constants.bannerText,
         onAction: bannerViewActionHandler)
-    
+
     private static var currentVersion: String?
     private static var controller: UIViewController?
+
+    public static var theme: ChangelogKitTheme = .defaultTheme {
+        didSet {
+            Log.error("Did set ChangelogKit theme to \(theme)")
+        }
+    }
     public static var changelogURL: String! {
         didSet {
-            Log.error("Did initialize ChangelogKit with \(changelogURL ?? "nil")")
+            Log.error("Did set ChangelogKit changelogURL to \(changelogURL ?? "nil")")
         }
     }
 
@@ -86,7 +114,7 @@ public class ChangelogKit {
             return
         }
         /// Initiate the WebView controller
-        let webController = WebViewController(url: url)
+        let webController = WebViewController(url: url, theme: theme)
         /// Set the presentation style depending the OS
         if #available(iOS 13, *) {
             webController.modalPresentationStyle = .automatic

ChangelogKit/Classes/Views/WebViewController.swift

@@ -18,9 +18,11 @@ private enum Constants {
 class WebViewController: UIViewController {
 
     @IBOutlet weak var webViewContainer: UIView!
+    @IBOutlet weak var theNavigationBar: UINavigationBar!
     @IBOutlet weak var theNavigationItem: UINavigationItem!
 
     private let url: URL
+    private let theme: ChangelogKitTheme
 
     private lazy var webView: WKWebView = {
         let config = getConfig()
@@ -30,11 +32,13 @@ class WebViewController: UIViewController {
         webView.allowsBackForwardNavigationGestures = false
         webView.contentMode = .scaleToFill
         webView.scrollView.delegate = webViewScrollViewDelegate.shared
+        webView.backgroundColor = theme.backgroundColor
         return webView
     }()
 
-    init(url: URL) {
+    init(url: URL, theme: ChangelogKitTheme) {
         self.url = url
+        self.theme = theme
         super.init(nibName: Constants.nibName, bundle: Bundle(for: type(of: self)))
     }
 
@@ -44,6 +48,8 @@ class WebViewController: UIViewController {
 
     override func viewDidLoad() {
         super.viewDidLoad()
+
+        view.backgroundColor = theme.backgroundColor
 
         setNavigationBar()
         setWebView()
@@ -65,6 +71,11 @@ class WebViewController: UIViewController {
             barButtonSystemItem: .done,
             target: self,
             action: #selector(doneTapped))
+
+        theNavigationBar.setBackgroundImage(UIImage(), for: .default)
+        theNavigationBar.shadowImage = UIImage()
+        theNavigationBar.isTranslucent = true
+        theNavigationBar.tintColor = theme.navigationBarTintColor
     }
 
     /// Function to bootstrap the `WKWebView`

ChangelogKit/Classes/Views/WebViewController.xib

@@ -1,16 +1,17 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<document type="com.apple.InterfaceBuilder3.CocoaTouch.XIB" version="3.0" toolsVersion="17701" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES">
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.XIB" version="3.0" toolsVersion="17506" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES">
     <device id="retina6_1" orientation="portrait" appearance="light"/>
     <dependencies>
         <deployment identifier="iOS"/>
-        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="17703"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="17505"/>
         <capability name="Safe area layout guides" minToolsVersion="9.0"/>
         <capability name="System colors in document resources" minToolsVersion="11.0"/>
         <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
     </dependencies>
     <objects>
         <placeholder placeholderIdentifier="IBFilesOwner" id="-1" userLabel="File's Owner" customClass="WebViewController" customModule="ChangelogKit" customModuleProvider="target">
             <connections>
+                <outlet property="theNavigationBar" destination="vE3-XS-Ssx" id="fr4-HF-vnE"/>
                 <outlet property="theNavigationItem" destination="jdZ-L1-RqD" id="3NA-FX-LzF"/>
                 <outlet property="view" destination="i5M-Pr-FkT" id="sfx-zR-JGt"/>
                 <outlet property="webViewContainer" destination="4Aq-pp-uhw" id="JYZ-Xb-25s"/>

Example/ChangelogKit/AppDelegate.swift

@@ -18,6 +18,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
 
         ChangelogKit.changelogURL = "https://voicepitchanalyzerchangelog.davidseek.md2site.com/"
+        ChangelogKit.theme = ChangelogKitTheme(navigationBarTintColor: .white, backgroundColor: .black)
         return true
     }
 }

Example/Podfile.lock

@@ -1,5 +1,5 @@
 PODS:
-  - ChangelogKit (0.1.0)
+  - ChangelogKit (0.1.5)
 
 DEPENDENCIES:
   - ChangelogKit (from `../`)
@@ -9,7 +9,7 @@ EXTERNAL SOURCES:
     :path: "../"
 
 SPEC CHECKSUMS:
-  ChangelogKit: b46592a901d62e4fa7e315c1279731fc70e78d80
+  ChangelogKit: cb4566e7f80de000c01c6bc1dd38550312bdd78a
 
 PODFILE CHECKSUM: 3a0b64bfe1be262873d0f3ec5a5c83a28748934d
 

Example/Pods/Local Podspecs/ChangelogKit.podspec.json

@@ -23,10 +23,21 @@ override func viewDidAppear(_ animated: Bool) {
 ```
 
 ## API
+
 - `useForce` 
   - `true`, presents the Changelog in a modal
   - `false`, presents a banner, with action buttons. Close, and present Changelog.
 
+## Theming
+
+The `ChangelogKitTheme` object offers a simple way to customize the Changelog experience with your Application Corporate Identity.
+
+```swift
+ChangelogKit.theme = ChangelogKitTheme(
+    navigationBarTintColor: .white, 
+    backgroundColor: .black)
+```
+
 ## Example
 
 To run the example project, clone the repo, and run `pod install` from the Example directory first.
@@ -42,7 +53,7 @@ pod 'ChangelogKit'
 
 ## Author
 
-davidseek, david@davidseek.com
+[David Seek](https://twitter.com/DavidSeek)
 
 ## License