mirror of
https://github.com/kiwix/kiwix-apple.git
synced 2025-09-26 05:18:31 -04:00
341f1031d3
* rename * project file ordering * multi reader * ZIm multi reader * search operation * project and bridging header * project setup * deprecate old search result class * search result class * search operation * search operation * html parser * deprecations * combine title search * sort * probability * remove title search * dispatch group parse * refactor * dispatch group async * first paragraph snippet * fix a small layout issue * parser * Revert "fix a small layout issue" This reverts commit d0f1cccefa3a5e63ed0643743da120bd2236c9f8. * SearchResultSnippetMode * search snippet setting * search snippet setting * prase first sentence * purge * refactor * prevent filter filter list become outdated * snippet max line count * iOS 12 cannot use first sentence as an option * more search results * language token * language token * rename none -> disabled * version bump * changelog
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.
- App Group must be different and unique (ex:
- Change the Signing profile to your account.