- Minimum iOS: 15.0
- Target SDK: 15.0
- Device Types Supported: iPhone
- Screen Sizes Supported: iPhone SE to iPhone 14 Pro Max
- Orientations Supported: Portrait, Landscape
- The icons used in the app are all custom. No additional licensing is required.
- Firebase Crashlytics (Apache License) - SDK for crash and non-fatal error reporting.
The following dependencies are used in the development environment only. They are not present in deployed code.
- LicensePlist (MIT License) - A tool to generate a list of third-party software licenses displayed in app settings.
- Mint (MIT License) - A package manager that installs and runs Swift command line tool packages.
- SnapshotTesting (MIT License) - Allow a snapshot test case which renders a UI component, takes a snapshot, then compares it to a reference snapshot file stored alongside the test.
- SwiftGen (MIT License) - A tool to automatically generate Swift code for project resources (like images, localized strings, etc), to make them type-safe to use.
- SwiftFormat (MIT License) - A tool used to reformat Swift code to automatically adjust for some style conventions.
- SwiftLint (MIT License) - A tool to enforce Swift style and conventions.
- ViewInspector (MIT License) - A tool used to unit test SwiftUI views.
- XcodeGen (MIT License) - Generates the Xcode project using the folder structure and a project spec.
-
Clone the repository:
$ git clone https://github.com/bitwarden/ios
-
Install Mint:
$ brew install mint
If you're using a Mac with Apple Silicon with Mint installed via Homebrew, you may see the SwiftGen build phase fail with the following error:
line 2: mint: command not found
If so, or if you just prefer to install Mint without
brew
, clone the Mint repo into a temporary directory and runmake
.$ git clone https://github.com/yonaskolb/Mint.git $ cd Mint $ make
-
Bootstrap the project:
$ Scripts/bootstrap.sh
Note Because
Scripts/bootstrap.sh
is how the project is generated,bootstrap.sh
will need to be run every time the project configuration or file structure has changed (for example, when files have been added, removed or moved). It is typically best practice to runbootstrap.sh
any time you switch branches or pull down changes.Alternatively, you can create git hooks to automatically execute the
bootstrap.sh
script every time a git hook occurs. To use the git hook scripts already defined in theScripts
directory, copy the scripts to the.git/hooks
directory.$ cp Scripts/post-merge .git/hooks/ $ cp Scripts/post-checkout .git/hooks/
- Open the project in Xcode 14.3+.
- Run the app in the Simulator with the
Bitwarden
target.
-
In Xcode's toolbar, select the project and a connected device or simulator.
- The
Generic iOS Device
used for builds will not work for testing.
- The
-
In Xcode's menu bar, select
Product > Test
.- Test results appear in the Debug Area, which can be accessed from
View > Debug Area > Show Debug Area
if not already visible.
- Test results appear in the Debug Area, which can be accessed from
This project is linted using both SwiftLint and SwiftFormat. Both tools run in linting mode with every build of the Bitwarden
target. However, if you would like to have SwiftFormat autocorrect any issues that are discovered while linting, you can manually run the fix command mint run swiftformat .
.
Additionally, if you would like SwiftFormat to autocorrect any issues before every commit, you can use a git hook script. To use the git hook script already defined in the Scripts
directory, copy the script to the .git/hooks
directory.
$ cp Scripts/pre-commit .git/hooks/
This project's structure is split into separate sections to support sharing as much code between all of the targets as possible. All core functionality and the majority of UI elements can be found in the BitwardenShared
framework.
GlobalTestHelpers
is a directory that contains helper files used in all test targets. This directory is included in each target that is defined in the project.yml
file.