+3
日增长
9,634
stars
1,108
forks
137
watchers
5,154
prs
2,275
issues
226
releases
README
Bitwarden Android
Contents
- Compatibility
- Setup
- Dependencies
- Documentation
Compatibility
- Minimum SDK: 29 (Android 10)
- Target SDK: 37 (Android 17)
- Device Types Supported: Phone and Tablet
- Orientations Supported: Portrait and Landscape
Setup
1. Clone the repository:
sh
$ git clone https://github.com/bitwarden/android
2. Create a user.properties file in the root directory of the project and add the following properties:
- gitHubToken: A "classic" Github Personal Access Token (PAT) with the read:packages scope (ex: gitHubToken=gph_xx...xx). These can be generated by going to the Github tokens page. See the Github Packages user documentation concerning authentication for more details.
- localSdk: A boolean value to determine if the SDK should be loaded from the local maven artifactory (ex: localSdk=true). This is particularly useful when developing new SDK capabilities. Review Linking SDK to clients for more details.
3. Setup the code style formatter:
All code must follow the guidelines described in the Code Style Guidelines document. To aid in adhering to these rules, all contributors should apply docs/bitwarden-style.xml as their code style scheme. In IntelliJ / Android Studio:
- Navigate to Preferences Editor Code Style.
- Hit the Manage button next to Scheme.
- Select Import.
- Find the bitwarden-style.xml file in the project's docs/ directory.
- Import "from" BitwardenStyle "to" BitwardenStyle.
- Hit Apply and OK to save the changes and exit Preferences.
Note that in some cases you may need to restart Android Studio for the changes to take effect.
All code should be formatted before submitting a pull request. This can be done manually but it can also be helpful to create a macro with a custom keyboard binding to auto-format when saving. In Android Studio on OS X:
- Select Edit Macros Start Macro Recording
- Select Code Optimize Imports
- Select Code Reformat Code
- Select File Save All
- Select Edit Macros Stop Macro Recording
This can then be mapped to a set of keys by navigating to Android Studio Preferences and editing the macro under Keymap (ex : shift + command + s).
Please avoid mixing formatting and logical changes in the same commit/PR. When possible, fix any large formatting issues in a separate PR before opening one to make logical changes to the same code. This helps others focus on the meaningful code changes when reviewing the code.
4. Setup JDK Version 21:
- Navigate to Preferences Build, Execution, Deployment Build Tools Gradle.
- Hit the selected Gradle JDK next to Gradle JDK:.
- Select a 21.x version or hit Download JDK... if not present.
- Select Version 21.
- Select your preferred Vendor.
- Hit Download.
- Hit Apply.
5. Setup detekt pre-commit hook (optional):
Run the following script from the root of the repository to install the hook. This will overwrite any existTop issues
#5329Unable to create passkey for WhatsApp90 comments · 2025-06-08#4650Must turn biometrics on and reset timeout every time app starts67 comments · 2025-01-30#4377UI Artifact / Black bar in Android Status Bar58 comments · 2024-11-24#5425AutoFill Missing in Chrome and Chrome Beta47 comments · 2025-06-26#5609[PM-24260] Brave Android app auto fill not working in http websites41 comments · 2025-07-29#4659Bitwarden crashing on biometric unlock36 comments · 2025-01-31#6164[PM-28157] Passkey error with Revolut app: 'Passkeys not supported for this app'30 comments · 2025-11-13#5014Webauthn 2FA not working in Android app30 comments · 2025-04-09
Latest release
Password Manager 2026.10.1 (21986) v2026.10.1-bwpm 2026-10-29Overview Create a new login from the generator tab Improved keyboard navigation Fixed autofill crashes on Android 10 Fixed autofill selection being lost after editing an item What's Changed ✨ Community Highlight [PM-43768] fix: preserve biometric unlock after transient Keystore authorization failure by @mvanhorn in https://github.com/bitwarden/android/pull/7399 :shipit: Feature Development PM-43004: feat: Add ability to create login from Generator by @david-livefront in https://github.com/bitwarden/android/pull/7453 PM-29851: feat: The interactive border should only b