The official Wikipedia iOS app.
- License: MIT License
- Source repo: https://github.com/wikimedia/wikipedia-ios
- Planning (bugs & features): https://phabricator.wikimedia.org/project/view/782/
- Team page: https://www.mediawiki.org/wiki/Wikimedia_Apps/Team/iOS
Note: Your Xcode version must be at least 16.0.
In the directory, run ./scripts/setup
. Note: going to scripts
directory and running setup
will not work due to relative paths.
Running scripts/setup
will setup your computer to build and run the app. The script assumes you have Xcode installed already. It will install homebrew, SwiftLint, and ClangFormat. It will also create a pre-commit hook that uses ClangFormat for linting Objective-C code.
After running scripts/setup
, you should be able to open Wikipedia.xcodeproj
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 a bug report.
If you'd rather install the development prerequisites yourself without our script:
- Xcode - 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 Apple ID registered with an Apple Developer account.
- SwiftLint - We use this for linting Swift code.
- ClangFormat - We use this for linting Objective-C code.
Covered in the contributing document.
These are general guidelines rather than hard rules.
- Objective-C - Apple's Coding Guidelines for Cocoa
- Swift - swift.org API Design Guidelines
We use Xcode's default 4 space indentation and our .clang-format
file with the pre-commit hook setup by scripts/setup
. Where possible, our Swift code is automatically formatted by SwiftLint based on the rules defined in .swiftlint-autocorrect.yml
.
Covered in the process document.
When reading logs, note that the log levels are shortened to emoji.
- 🗣️ Verbose
- 💬 Debug
- ℹ️ Info
⚠️ Warning- 🚨 Error
The app only writes Warning and Error messages to the console for both Debug and Release mode. If you need to log all messages temporarily during troubleshooting, update this level to DDLogLevelAll.
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. In order for the tests to pass, the test device's language and region must be set to en-US
in Settings → General → Language & Region. There is a ticket filed to update the tests to pass regardless of language and region.
-
Wikipedia - Points to production servers.
-
Staging - Points to various staging server environments. You can adjust these environments by changing the
current
property ofConfiguration
:- An option of
appsLabsForPCS
will point to the Apps team's staging environment for page content. - An option of
betaCluster
will point to the MediaWiki beta cluster environment for most API calls. This is meant to be a more blanket environment setting, so if this value exists it will also force the beta cluster environment for page content on the article view. This beta cluster environment is also where developers can test sandbox push notifications triggered across various wikis. This is selected by default.
The Staging scheme also has our feature flags set to true. It displays features that are still in development. It is pushed to TestFlight as a separate app.
- An option of
-
Experimental - For one-off builds, to demonstrate early development or prototype features. This points to production servers by default, but can be adjusted to whatever server environment is needed via temporary adjustments in
Configuration
. We also sometimes use it for design review, before features go through PR review. It is pushed to TestFlight as a separate app. -
Local Page Content Service and Announcements - used by engineers in Debug-mode only. This has the ability to toggle different local environments within the
current
property ofConfiguration
:- An option of
localPCS
will point to a locally running mobileapps repository for page content. This is selected by default. - An option of
localAnnouncements
will point to a locally running wikifeeds repository for the announcements endpoint. This is selected by default. - All other endpoints will point to production.
- An option of
-
RTL - Launches the app in an RTL locale using the
-AppleLocale
launch argument. This is used by engineers in Debug-mode only. -
Performance Testing - This is a duplicate scheme of Wikipedia, but uses the Release configuration in its Run step instead of Debug. We use this scheme when we manually run performance tests as a part of our pre-release checklist.
-
WMF - Bundles up the app logic shared between the main app and the extensions (widgets, notifications).
-
Update Localizations - Covered in the localization document.
-
Update Languages - For adding new Wikipedia languages or updating language configurations. Covered in the languages document.
-
{{name}}Widget, {{name}}Notification, {{name}}Stickers - Extensions for widgets, notifications, and stickers.
Covered in the CI document.
The article view and several other components of the app rely on web components. Instructions for working on these components are covered in the web development document.
If you have any questions or comments, you can email us at ios-support[at]wikimedia dot org. We'll also gladly accept any bug reports.