Welcome to the Next iteration of the Pocket iOS client, currently in development.
pocket-ios requires a secrets.xcconfig file to run and secrets_test.xcconfig file to test, we have included some mock secrets in the repo but if you are a Mozillan or Pocketeer you can obtain the actual secret keys from the Pocket Team.
External contributors may generate their own Pocket API keys at https://getpocket.com/developer/ though some features (payments, for example) will still not work.
Once obtained you can run the following command from the root directory:
cp Config/secrets.xcconfig.example Config/secrets.xcconfig
Then replace values in
Config/secrets.xcconfig with the values you have received.
After you will need to run the API Generation steps below.
To run our UITests locally, you will need an instance of Snowplow Micro running on your system on port 9090.
We use Docker for this purpose. You can install Docker using Homebrew:
brew install docker
Or you may download it from the Docker website
Once installed you need to provide your Docker username to the iOS lead so they can add you to the Pocket docker Organisation.
Once done you can simply run
docker compose up in Terminal from the root Pocket directory to run an instance of Snowplow Micro.
###Snowplow Micro Snowplow micro has 4 endpoints of note:
[SnowplowMicro](https://raw.github.com/Pocket/pocket-ios/develop/./Tests iOS/Support/SnowplowMicro) class is used to interact with Snowplow and provide helper assertions to make testing events easier.
Pocket for iOS uses Apollo client to autogenerate its API schema code. You will need to run the following commands every time the APIs you use change or if you change your API queries.
To Start run the following command:
swift package --allow-writing-to-package-directory apollo-cli-install
To download a new version of
PocketKit/Sources/Sync/schema.graphqls you can run the following commands:
To download a new version of
PocketKit/Sources/Sync/API.swift you can run the following commands:
To modify/create a request look into
Any modifications done here and after you generate above will be auto-generated in our codebase for usage.
Previously we used a singleton
PocketSource, but we are moving away from that model and instead encourage the adoption of a protocol Service. As an example, you can look at
We plan on implementing the following changes in the future:
PocketKit/Sources/PocketGraph/ are generated on demand at build time.
Pocket uses custom fonts: Graphik & Blanco. In order for the styles to present as expected in your local build you need to obtain the font files. Mozillians and Pocketeers can request them from the iOS manager and install them in
PocketKit is the foundation of all of Pocket. Pocket is purposefully abstracted into a Kit so that we can define multiple targets in the Apple Ecosystem and still use the same code base. Here you can find the view controllers, app delegates and most entrypoints into the Pocket application.
Sync is the main API & Core Data layer that Pocket is built on. This library provides the work needed to communicate with the Pocket API and our Offline storage layer, backed by CoreData.
Textile provides the standard views and styles that can be re-used across all of the Pocket targets we create in the Apple Ecosystem.
Analytics provides Pocket's implementation of Snowplow which we use to provide a feedback loop to the Pocket product team into how our features are used.
SaveToPocketKit is the code base needed to make the Pocket Share Extension function and is embeded in the SaveToPocket Extension that enables you to Save to Pocket from other applications.
SharedPocketKit is for code that is shared between PocketKit and SaveToPocketKit. It contains code for session management and keychain storage that is used across all apps in the Pocket App Group.
See our Contribution Guide for day-to-day Pocket development guides.
When you add a dependncy we need to ensure that our OpenSource Licenses are up to date with all licenses we are using.
The following are the high level steps to update the notices page:
|Last commit: 13 hours ago