Kiwix for iOS & macOS

This is the home for Kiwix apps on iOS and macOS.

Mobile app for iPads & iPhones

• Download the iOS mobile app on iTunes App Store

Kiwix Desktop for macOS

• Download Kiwix Desktop on iTunes App Store
• Download Kiwix Desktop DMG file

Developers

Dependencies

• An Apple Developer account (doesn't require membership)
• Latest Apple Developers Tools (Xcode)
• Its command-line utilities (xcode-select --install)
• CocoaPods sudo gem install cocoapods && pod repo update
• kiwix-lib

Building kiwix-lib

Instructions are available on the kiwix-build repo.

git clone https://github.com/kiwix/kiwix-build.git
cd kiwix-build
# if on macOS mojave (10.14), install headers to standard location
# https://developer.apple.com/documentation/xcode_release_notes/xcode_10_release_notes?language=objc
open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg
kiwix-build --target-platform iOS_multi kiwix-lib
# assuming ../apple points to this repository
cp -vr BUILD_iOS_multi/INSTALL/include ../apple/Shared/Dependencies/
cp -vr BUILD_iOS_multi/INSTALL/lib ../apple/Shared/Dependencies/iOS_lib

Building Kiwix iOS or Kiwix macOS

• Install Pods dependencies pod install
• Open project with Xcode open Kiwix.xcworkspace
• Change the App groups (in Capabilities) and Bundle Identifier for both iOS and Bookmarks targets
  • App Group must be different and unique (ex: tld.mydomain.apple)
  • iOS Bundle Identifier must be different and unique (ex: tld.mydomain.apple.Kiwix)
  • Bookmarks Bundle Identifier must be a child of iOS one (ex: tld.mydomain.apple.Kiwix.Bookmarks)
  • ⚠ if you are using a regular (non-paying) Apple Developer Account, you are limited in the number of App IDs you can use so be careful not to fumble much with those.
• Change the Signing profile to your account.