/pocket-casts-android

Pocket Casts Android 🎧

Primary LanguageKotlinMozilla Public License 2.0MPL-2.0

Pocket Casts is the world's most powerful podcast platform, an app by listeners, for listeners.

Install

If you're just looking to install Pocket Casts Android, you can find it on Google Play. If you're a developer wanting to contribute, read on.

Build Instructions

  1. Make sure you've installed Android Studio.
  2. In Android Studio, open the project from the local repository.
  3. Go to Tools β†’ Device Manager and create an emulated device.
  4. Go to Run β†’ Edit Configurations… and create an Android App configuration.
  5. Select the module "pocketcasts-android.app.main".
  6. Run.

Build and Test

To build, install, and test the project from the command line:

$ ./gradlew :app:assembleDebugProd          # assemble the debug .apk
$ ./gradlew :app:installDebugProd           # install the debug .apk to a connected device
$ ./gradlew :app:testDebugUnitTest          # assemble, install and run unit tests
$ ./gradlew :app:connectedDebugAndroidTest  # assemble, install and run Android tests

Directory structure

.
β”œβ”€β”€ app                    # Mobile app
β”œβ”€β”€ automotive             # Automotive app
β”œβ”€β”€ modules
β”‚   β”œβ”€β”€ features
β”‚   β”‚   β”œβ”€β”€ account        # Create account and sign in pages.
β”‚   β”‚   β”œβ”€β”€ cartheme       # Automotive resources needed for the account pages.
β”‚   β”‚   β”œβ”€β”€ discover       # Discover section.
β”‚   β”‚   β”œβ”€β”€ filters        # Filters section.
β”‚   β”‚   β”œβ”€β”€ navigation     # Navigation utilities.
β”‚   β”‚   β”œβ”€β”€ player         # Full screen player
β”‚   β”‚   β”œβ”€β”€ podcasts       # Podcasts section.
β”‚   β”‚   β”œβ”€β”€ profile        # Profile section.
β”‚   β”‚   β”œβ”€β”€ search         # Search pages.
β”‚   β”‚   └── settings       # Settings pages.
β”‚   └── services
β”‚       β”œβ”€β”€ compose        # Shared Compose code.
β”‚       β”œβ”€β”€ images         # Image resources.
β”‚       β”œβ”€β”€ localization   # Contains the strings in English and localized strings from GlotPress. 
β”‚       β”œβ”€β”€ model          # The database logic and entities. Also transfer objects required which aren't stored in the database.
β”‚       β”œβ”€β”€ preferences    # Stores the user preferences and configuration settings.
β”‚       β”œβ”€β”€ repositories   # Provides accessing to the data from the 'servers' and 'model' modules.
β”‚       β”œβ”€β”€ servers        # Provides the network calls to the servers. The UI layer should access these through the 'repositories' module.
β”‚       β”œβ”€β”€ ui             # Shared UI code for the 'compose' and 'views' modules. This includes the themes.
β”‚       β”œβ”€β”€ utils          # Utility classes.
β”‚       └── views          # Shred Only the old views code.

Contributing

Read our Contributing Guide to learn about reporting issues, contributing code, and more ways to contribute.

Security

If you happen to find a security vulnerability, please let us know at https://hackerone.com/automattic and allow us to respond before disclosing the issue publicly.

Documentation

Signing a Release

To build a signed release, add these lines to your ~/.gradle/gradle.properties file

pocketcastsKeyStoreFile=/Users/username/git/secret.keystore
pocketcastsKeyStorePassword=
pocketcastsKeyStoreAlias=
pocketcastsKeyStoreAliasPassword=