git clone https://github.com/NYPL/Simplified-iOS.gitorgit clone git@github.com:NYPL-Simplified/Simplified-iOS.gitcd Simplified-iOSgit submodule update --init --recursive- Install Cocoapods if you haven't already.
pod install- Symlink the "DRM_Connector_Prerelease" directory to "adobe-rmsdk" within the "Simplified-iOS" directory. (You will need to have obtained the Adobe DRM Connector prerelease from Adobe.)
- Follow the instructions in "adobe-rmsdk/RMSDK_User_Manual(obj).pdf" to build OpenSSL (section 12.1) and cURL (section 12.3).*
sh adobe-rmsdk-build.shcp APIKeys.swift.example Simplified/APIKeys.swiftand edit accordingly.open Simplified.xcworkspace- Build.
* If you want to release your app in Apple's App Store, you must add --enable-ipv6 to line 80 of Adobe's "build.sh" script used for building cURL. Without that flag, cURL will not provide proper support for IPv6 and therefore Apple will reject your application.
Note: This configuration is not currently supported. In the interim, you should be able to get it to build via the following steps:
git clone https://github.com/NYPL/Simplified-iOS.gitorgit clone git@github.com:NYPL-Simplified/Simplified-iOS.gitcd Simplified-iOSgit submodule deinit adept-ios && git rm -rf adept-iosgit submodule deinit adobe-content-filter && git rm -rf adobe-content-filtergit submodule update --init --recursive- Install Cocoapods if you haven't already.
pod installcp APIKeys.swift.example Simplified/APIKeys.swiftand edit accordingly.open Simplified.xcworkspace- Remove "Simplified+RMSDK.xcconfig" from the project.
- Delete "libADEPT.a" and "libAdobe Content Filter.a" from "Link Binary with Libraries" for the "SimplyE" target.
- Build.
This codebase follows Google's Objective-C Style Guide including the use of two-space indentation. Both Objective-C and Swift may be used for new code.
The primary services/singletons within the program are as follows:
NYPLAccountNYPLBookCoverRegistry(used directly only byNYPLBookRegistry)NYPLBookRegistryNYPLConfigurationNYPLKeychainNYPLMyBooksDownloadCenter
All of the above contain appropriate documentation in the header files.
The rest of the program follows Apple's usual pattern of passive views, relatively passive models, and one-off controllers for integrating everything. Immutability is preferred wherever possible.
Questions and suggestions should be submitted as GitHub issues and tagged with
the appropriate labels. More in-depth discussion occurs via Slack: Email
jamesenglish@nypl.org for access.
Copyright © 2015 The New York Public Library, Astor, Lenox, and Tilden Foundations
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.