Press is primarily developed on IntelliJ IDEA. If you're new to Android, importing the project on IntelliJ IDEA should walk you through all the steps needed for running the app. Please feel free to ask if that's not the case.
Press uses SwiftUI so you'll need macOS Catalina or higher. You can run the project by importing native/mac/mac.xcworkspace
.
Although being the official IDE, Xcode isn't very good in comparison to IntelliJ's IDEs. If you share the same frustration or want a familiar environment setup when working with two platforms, using AppCode might be a good idea. Keep in mind of these gotchas:
-
AppCode doesn't re-generate Swift interfaces when shared code is updated. The project builds fine when new APIs are used, but autocomplete doesn't recognize them until a project restart. https://youtrack.jetbrains.com/issue/OC-20012.
-
AppCode fails to resolve type parameter in a
ViewModifier
: https://youtrack.jetbrains.com/issue/OC-20058. -
Swift Package Dependencies aren't supported, but support for it is supposed to be released soon. In the meantime, a workaround is mentioned here: https://youtrack.jetbrains.com/issue/OC-19012. Press doesn't use SPM so this not an issue yet.
Press uses GitHub for syncing notes with a git repository. If you wish, you can register your own GitHub app and add its client secret key to shared/secrets.properties
:
github_client_id=...
github_client_secret=...
For ensuring sync is working as expected, Press runs its tests on a real repository. If the tests need to be run locally, you can specify your repository:
git_test_repo_ssh_url=git@github.com:user/ExampleRepository.git
git_test_repo_branch=main
git_test_ssh_private_key=...