WordPress for iOS

Blog: http:https://make.wordpress.org/mobile

Handbook: http:https://make.wordpress.org/mobile/handbook/

https://github.com/wordpress-mobile/WordPress-iOS/wiki/WordPress-for-iOS-Style-Guide

https://github.com/wordpress-mobile/WordPress-iOS/issues

GitHub: https://github.com/wordpress-mobile/WordPress-iOS/

http:https://make.wordpress.org/mobile/handbook/pathways/ios/how-to-contribute/

We use a few tools to help with development. To install or update the required dependencies, run rake dependencies from the command line.

WordPress for iOS uses CocoaPods (http:https://cocoapods.org/) to manage third party libraries. Trying to build the project by itself (WordPress.xcproj) after launching will result in an error, as the resources managed by CocoaPods are not included.

Run rake dependencies from the command line to install dependencies for the project. This will ensure the current supported version of CocoaPods is used. If you have the same version installed in your system, you can also run pod install.

We use SwiftLint to enforce a common style for Swift code. Xcode will show a warning if you don't have it installed. The app should build and work without it, but if you plan to write code, you are encouraged to install it. No commit should have lint warnings or errors.

SwiftLint runs automatically when you build the project, but you can run it manually from the command line with rake lint

If your code has any style violations, you can try to automatically correct them by running rake lint:autocorrect. Otherwise you have to fix them manually.

Launch the workspace by running rake xcode from the command line. This will ensure any dependencies are ready before launching Xcode. You can also open the project by double clicking on WordPress.xcworkspace file, or launching Xcode and choose File > Open and browse to WordPress.xcworkspace.

WordPress for iOS requires Swift 2.2 and Xcode 7.3 or newer. Previous versions of Xcode can be downloaded from Apple.

More information on building the project and the tools required can be found in the handbook.

In order to login to a WordPress.com account, you will need to create an account over at https://developer.wordpress.com. The only account you will be able to login in with is the one affiliated with your developer account. Once you have an account and a corresponding app id and app secret, you will need to setup a ~/.wpcom_app_credentials file as detailed here. For more details see http:https://developer.wordpress.com/2014/07/04/authentication-improvements-for-testing-your-apps/.

WordPress for iOS is an Open Source project covered by the GNU General Public License version 2.