wikipedia-ios 0,0,0,3,0,5

The official Wikipedia iOS app.

Wikipedia iOS

The official Wikipedia iOS client.

Build Status codecov.io MIT license

Development Team

The app is primarily being developed by the Wikimedia Foundation’s Mobile Apps team. This README provides high-level guidelines for getting started with the project. If you have any questions, comments, or issues, the easiest way to talk to us is joining the #wikimedia-mobile channel on the freenode IRC server during Eastern and Pacific business hours. We’ll also gladly accept any tickets filed against the project in Phabricator.

Building and Running

###Minimum Requirements: * Xcode 8.2.1 or higher The easiest way to get Xcode is from the App Store, but you can also download it from developer.apple.com if you have an AppleID registered with an Apple developer account.

**If you’d rather not install the remaining dependencies yourself, you can run scripts/setup from the project directory to install them. This may take awhile as it will also compile any code dependencies.

At this point, you should be able to open Wikipedia.xcodeproject and run the app on the iOS Simulator (using the Wikipedia scheme and target). If you encounter any issues, please don’t hesitate to let us know via bug reports or messaging us on IRC (see above).

Quick note: you might not see an app icon when first building the project after a clean checkout. See Wikipedia App Icons for information about generating the icons.

Development

Architecture

TODO: We hope to have some high-level documentation on the application’s architecture soon.

Best practices and coding style

You can find our current thinking on iOS best practices and coding style on our team page. The WMFCodingStyle files are also canonical examples of our coding style, which are enforced using clang-format.

Dependencies

We use Carthage to manage third-party native dependencies and npm for web.

Testing

The Wikipedia scheme is configured to execute the project’s iOS unit tests, which can be run using the Cmd+U hotkey or the Product->Test menu bar action. You can also use the project’s Makefile to run both in one action: make verify.

Contributing

If you’re interested in contributing to the project, you can find our current product, bug, and engineering backlogs on the iOS App Phabricator project board. Once you pick a task, make sure you assign it to yourself to ensure nobody else duplicates your work. The #Easy tag in Phabricator can also help you find tasks that are ideal for new contributors because they’re small and/or well-defined. We suggest you filter the #Easy project to only show tasks in the Wikipedia iOS app projects.

We do all of our active development on the develop branch. Your pull requests will automatically be targeted at that branch by Github. To make merging easier, be sure you create your branches based on the develop branch.

Once your contributions are ready for review, post a pull request on GitHub and Travis should verify your changes. Once the build succeeds, one of the maintainers will stop to approve the changes for merging.

Gerrit

We also maintain a mirror of this repository on Gerrit (see above), syncing the code after every release. If you’d rather use Gerrit to send us a patch, you’ll need to:

Other Development Dependencies

Certain development and maintenance tasks will require the installation of specific tools. Many of these tools are installable using Homebrew, which is our recommended package manager.

Homebrew and many other tools require the Xcode command line tools, which can be installed by running xcode-select --install on newer versions of OS X. They can also be installed via Xcode or downloaded from the Apple Developer downloads page on older versions of OS X.

Clang-Format

brew install clang-format

As mentioned in best practices and coding style, we use clang-format to lint the project’s Objective-C code. Installation via Homebrew is straightforward: brew install clang-format. We use the ClangFormat-Xcode plugin to format code on save. After installing the Xcode plugin, select “Format on Save”, “Use System ClangFormat” and “File” (to use our .clang-format file) from the Edit > Clang Format menu. You already have clang format if you ran one of the setup scripts above.

NPM

brew install npm

npm is a package manager for nodejs. With it, we install various node modules as Javascript dependencies and development tools (see www/package.json for an up-to-date list). Similar to our native dependencies, we have committed certain files to the repository to remove node and npm as build dependencies in an effort to streamline typical application development. Please see Wikipedia iOS Web Development for more information about how to work with the web components in this project.

Fastlane

fastlane

Continuous Integration

Continuous integration is run on Travis-CI in response to pull request updates and merges to the master branch. See the verify lane in fastlane/Fastfile and our .travis.yml for details.

Related Repositories

wikipedia-ios

wikipedia-ios

The official Wikipedia iOS app. ...

GlaZoo

GlaZoo

My project for Culture Hack Scotland 2012. Titanium app (iOS) using Glasgow Museums Zoology data mashed up with some wikipedia images. ...


Top Contributors

coreyfloyd montehurd bgerstle joewalsh wmf-apps-ci brion dr0ptp4kt ndis1 nirzar niedzielski berndsi barbaramartina josve05a huayu0723 Deskana hhanke mdholloway Gabicoware siebrand legoktm Krinkle jberkel dusek anirudh24seven yuvipanda negati-ve hashar bart-kneepkens cromulentlabs jtminor

Releases

-   v4.0.1-rc1 zip tar
-   v4.0-rc2 zip tar
-   v4.0-rc1 zip tar
-   testTag2 zip tar
-   testTag zip tar
-   test-tag zip tar
-   stabletf/4.0.7.6-sta zip tar
-   stabletf/4.0.7.5-sta zip tar
-   releases/5.2.1.942.1 zip tar
-   releases/5.2.0.939 zip tar
-   releases/5.2.0.929.1 zip tar
-   releases/5.1.1.920.1 zip tar
-   releases/5.1.0.918.1 zip tar
-   releases/5.1.0.917.1 zip tar
-   releases/5.1.0.916.1 zip tar
-   releases/5.1.0.913.1 zip tar
-   releases/5.0.6.909.1 zip tar
-   releases/5.0.6.908.1 zip tar
-   releases/5.0.6.907.1 zip tar
-   releases/5.0.6.906.1 zip tar
-   releases/5.0.5.904.1 zip tar
-   releases/5.0.5.904.1 zip tar
-   releases/5.0.5.903.1 zip tar
-   releases/5.0.5.902.1 zip tar
-   releases/5.0.5.901.1 zip tar
-   releases/5.0.5.900.1 zip tar
-   releases/5.0.5.898.1 zip tar
-   releases/5.0.5.896.1 zip tar
-   releases/5.0.5.896.1 zip tar
-   releases/5.0.5.896.1 zip tar