50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
<!--
|
|
Seed README for the PUBLIC distribution repo `3HL-SCORE/public-sdks-score` (#284).
|
|
Copy this to that repo's root as README.md when publishing. Source of truth for
|
|
the SDK lives in the private score-anything-loyalty repo under `mobile/`.
|
|
-->
|
|
# Score mobile SDKs (public distribution)
|
|
|
|
Public, auth-free distribution of the **Score mobile tracker** SDKs for iOS and Android — the mobile counterpart of the web `@3halves-labs/score-tracker`. Lightweight app analytics / fan-engagement tracking with a durable offline queue, consent gating, and Auth0 JWT support.
|
|
|
|
> This repo hosts the **consumable artifacts** (release assets + package manifests). The SDK source lives in 3 Halves Labs' private platform repo.
|
|
|
|
## Install — 0.2.0 (no token / login required)
|
|
|
|
### iOS — Swift Package Manager
|
|
```bash
|
|
swift package-registry set https://git.3halves-labs.com/api/packages/3HL-SCORE/swift
|
|
```
|
|
```swift
|
|
// Package.swift
|
|
dependencies: [ .package(id: "threehalveslabs.ScoreTracker", from: "0.2.0") ]
|
|
// target: .product(name: "ScoreTracker", package: "ScoreTracker")
|
|
```
|
|
|
|
### iOS — CocoaPods
|
|
```ruby
|
|
pod 'ScoreTracker',
|
|
:podspec => 'https://git.3halves-labs.com/3HL-SCORE/public-sdks-score/raw/branch/main/ScoreTracker.podspec'
|
|
```
|
|
|
|
### iOS — direct XCFramework
|
|
Download `ScoreTrackerKit.xcframework.zip` from the [`mobile-v0.2.0` release](https://git.3halves-labs.com/3HL-SCORE/public-sdks-score/releases) and drag it into Xcode.
|
|
|
|
### Android — Gradle
|
|
```kotlin
|
|
repositories {
|
|
maven { url = uri("https://git.3halves-labs.com/api/packages/3HL-SCORE/maven") } // public — no credentials
|
|
}
|
|
dependencies {
|
|
implementation("com.threehalveslabs.scoretracker:shared-android:0.2.0")
|
|
}
|
|
```
|
|
|
|
## Quickstart & API
|
|
|
|
See the full integration guide (init, consent, Auth0, offline/flush, event catalogue): **`INTEGRATION.md`** in this repo (published alongside each release).
|
|
|
|
## Support
|
|
|
|
Issues / integration questions: contact 3 Halves Labs. Versions are tagged `mobile-v<version>`.
|