https://github.com/skiptools/skip-marketplace
Interface to marketplace services such as the Apple App Store and Google Play Store
https://github.com/skiptools/skip-marketplace
Last synced: 8 months ago
JSON representation
Interface to marketplace services such as the Apple App Store and Google Play Store
- Host: GitHub
- URL: https://github.com/skiptools/skip-marketplace
- Owner: skiptools
- License: other
- Created: 2025-10-04T15:40:17.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-04T18:50:23.000Z (8 months ago)
- Last Synced: 2025-10-04T19:27:30.124Z (8 months ago)
- Language: Swift
- Size: 16.6 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.LGPL
Awesome Lists containing this project
README
# SkipMarketplace
This module provide support for interfacing with an app's
marketplace, such as the Google Play Store for Android
and the Apple App Store for iOS.
Currently, the framework provides the ability to request
a store rating for the app from the user. In the future,
this framework will provide the ability to perform
in-app purchases and subscription management.
## Setup
To include this framework in your project, add the following
dependency to your `Package.swift` file:
```swift
let package = Package(
name: "my-package",
products: [
.library(name: "MyProduct", targets: ["MyTarget"]),
],
dependencies: [
.package(url: "https://source.skip.tools/skip-marketplace.git", "0.0.0"..<"2.0.0"),
],
targets: [
.target(name: "MyTarget", dependencies: [
.product(name: "SkipMarketplace", package: "skip-marketplace")
])
]
)
```
## App Review Requests
You can use this library to request that the app marketplace show a prompt to the user requesting a rating for the app for the given marketplace.
```swift
import SkipMarketplace
// request that the system show an app review request at most once every month
Marketplace.current.requestReview(period: .days(31))
```
For guidance on how and when to make these sorts of requests, see the
relevant documentation for the
[Apple App Store](https://developer.android.com/guide/playcore/in-app-review#when-to-request)
and
[Google PlayStore](https://developer.apple.com/design/human-interface-guidelines/ratings-and-reviews#Best-practices).
## Listing and purchasing digital goods
### Android Configuration
You must set the `com.android.vending.BILLING` permission in your `AndroidManifest.xml` file like so:
```xml
```
## Building
This project is a free Swift Package Manager module that uses the
[Skip](https://skip.tools) plugin to transpile Swift into Kotlin.
Building the module requires that Skip be installed using
[Homebrew](https://brew.sh) with `brew install skiptools/skip/skip`.
This will also install the necessary build prerequisites:
Kotlin, Gradle, and the Android build tools.
## Testing
The module can be tested using the standard `swift test` command
or by running the test target for the macOS destination in Xcode,
which will run the Swift tests as well as the transpiled
Kotlin JUnit tests in the Robolectric Android simulation environment.
Parity testing can be performed with `skip test`,
which will output a table of the test results for both platforms.
## License
This software is licensed under the
[GNU Lesser General Public License v3.0](https://spdx.org/licenses/LGPL-3.0-only.html),
with the following
[linking exception](https://spdx.org/licenses/LGPL-3.0-linking-exception.html)
to clarify that distribution to restricted environments (e.g., app stores) is permitted:
> This software is licensed under the LGPL3, included below.
> As a special exception to the GNU Lesser General Public License version 3
> ("LGPL3"), the copyright holders of this Library give you permission to
> convey to a third party a Combined Work that links statically or dynamically
> to this Library without providing any Minimal Corresponding Source or
> Minimal Application Code as set out in 4d or providing the installation
> information set out in section 4e, provided that you comply with the other
> provisions of LGPL3 and provided that you meet, for the Application the
> terms and conditions of the license(s) which apply to the Application.
> Except as stated in this special exception, the provisions of LGPL3 will
> continue to comply in full to this Library. If you modify this Library, you
> may apply this exception to your version of this Library, but you are not
> obliged to do so. If you do not wish to do so, delete this exception
> statement from your version. This exception does not (and cannot) modify any
> license terms which apply to the Application, with which you must still
> comply.