Release 0.3.0: version, README (banners, native ads, impression data, segments, limitations, example app, Capacitor 7), CHANGELOG

This commit is contained in:
CRTkafa 2026-10-10 05:43:29 +08:00
parent 8dde08bcd9
commit 6733e8bdae
3 changed files with 216 additions and 27 deletions

View file

@ -6,7 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
## [Unreleased]
### Added (API design for 0.3.0)
## [0.3.0] - 2026-10-10
Banners, native ads, impression-level revenue, segments, dynamic user id, placement capping and Capacitor 7 support.
Fully backwards compatible with 0.2.x.
### Added (API)
- `docs/design-0.3.md`: banner, native ad, impression data, placement, segment and dynamic user id design with the
exact LevelPlay 9.6.1 Android / iOS mappings, overlay positioning, error codes, Capacitor 7 findings, test plan.
- TypeScript API (`@since 0.3.0`): `getCapabilities`, `setSegment`, `setDynamicUserId`, `isPlacementCapped`,
@ -16,7 +21,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
- `AdInfo` gains optional `ab`, `segmentName`, `encryptedCPM`, `creativeId`, `conversionValue` (iOS) and `adSize`.
- Web stubs for every new method.
### Added (Android bridge for 0.3.0)
### Added (Android)
- Banners in a pass-through overlay above the WebView: presets, `ADAPTIVE` (width in dp = CSS px, recreated on
rotation), `CUSTOM` sizes, top / bottom / center with offsets, safe area from the WebView's on-screen rect and the
window insets, several banners by id, every `banner*` event.
@ -27,7 +32,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
- JVM unit tests for the overlay geometry and argument validation (`bun run verify:android`).
- `BannerSize` `CUSTOM` with `customSize`, `NativeAdTemplateStyle` fonts, banner ids in `LEVELPLAY_DEMO`.
### Added (iOS bridge for 0.3.0)
### Added (iOS)
- Banners in a pass-through overlay inside the WebView: presets, `ADAPTIVE` (width in pt = CSS px, recreated when the
safe-area width changes), `CUSTOM` sizes, top / bottom / center with offsets, safe area, several banners by id, every
`banner*` event.
@ -38,6 +43,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
`isPlacementCapped`, `getReward`; cleanup of banners and native ads when the plugin is released.
- `AdInfo` fields `ab`, `segmentName`, `encryptedCPM`, `creativeId`, `conversionValue`, `adSize` on iOS.
### Added (tooling and docs)
- `bun run test`: `bun test` for the web stub (unimplemented rejections vs no-ops), `LEVELPLAY_DEMO` and the exports,
plus a compile-only check of the public API (`tsc -p test`); `verify` runs it.
- `example-app/`: a minimal Capacitor 8 app (HTML + TypeScript, esbuild) with the demo ids and buttons for every
format, segments and an impression log; Android and iOS (SPM) platforms committed. Not part of the npm package.
- README: banners, native ads (style options), impression data, segments / user id / placements, error codes,
limitations, example app, Capacitor 7.
### Changed
- Capacitor 7 support: `peerDependencies` `@capacitor/core >=7.0.0`; `Package.swift` depends on `capacitor-swift-pm`
`"7.0.0"..<"9.0.0"`; iOS deployment target 14.0 in `Package.swift` and the podspec (was 15.0); Android
`minSdkVersion` fallback 23 (was 24). Checked by building a Capacitor 7.6.9 app for Android and the iOS simulator.
## [0.2.1] - 2026-10-10
### Changed
@ -79,7 +97,8 @@ First public release on npm. No behaviour changes to the native bridges since 0.
`closed` `rewarded`. Show calls resolve after close with `{ shown, rewarded, reward?, error? }`.
- `LEVELPLAY_DEMO`: Unity's public demo app keys and ad unit ids.
[Unreleased]: https://git.crt.fyi/CRT/capacitor-levelplay/compare/v0.2.1...main
[Unreleased]: https://git.crt.fyi/CRT/capacitor-levelplay/compare/v0.3.0...main
[0.3.0]: https://git.crt.fyi/CRT/capacitor-levelplay/compare/v0.2.1...v0.3.0
[0.2.1]: https://git.crt.fyi/CRT/capacitor-levelplay/compare/v0.2.0...v0.2.1
[0.2.0]: https://git.crt.fyi/CRT/capacitor-levelplay/compare/v0.1.0...v0.2.0
[0.1.0]: https://git.crt.fyi/CRT/capacitor-levelplay/releases/tag/v0.1.0