/ios-mac-app

Official ProtonVPN iOS and macOS app

Primary LanguageSwiftGNU General Public License v3.0GPL-3.0

ProtonVPN for iOS and macOS

Copyright (c) 2021 Proton Technologies AG

Dependencies

This app uses CocoaPods for most dependencies. Everything is inside this repository, so no need to run pod install.

Third-party dependencies

ACKNOWLEDGEMENTS.md

Setup

  • Enable Git LFS on your machine
  • Clone this repository
  • Make sure you have go installed (brew install go)
  • Configure code signing for all targets with a paid Apple developer account (required due to VPN entitlements) and change the bundle identifiers to something unique
  • Clean build folder in Xcode (Cmd+Shift+K)
  • Build app twice

Code linting

During development swiftlint is run on non-strict mode so it's easier to develop without worrying about code formatting. On CI, linting is strict and will fail on any warning. Before commiting code to this repository run the following script to add a pre-commit hook that will check all new/modified files in strict mode and stop you from committing code that won't make it through CI.

./scripts/pre_commit_lint.sh setup

Localization

The app uses SwiftGen to generate the Localizable.strings file for accessing all the app strings stored in the standard Localizable.strings files. Just add a new string, build the project and Localizable.strings gets regenerated with the new string. The configuration can be found in libraries/vpncore/swiftgen.yml.

Obscure XCode errors

If you get obscure XCode errors like an error from swiftlint without a place where it comes from, switch to vpncore-ios or vpncore-macos scheme and build it. Most probably lint error is in the Core project.

License

The code and data files in this distribution are licensed under the terms of the GPLv3 as published by the Free Software Foundation. See https://www.gnu.org/licenses/ for a copy of this license.

Copyright (c) 2021 Proton Technologies AG