69 lines
7.6 KiB
Markdown
69 lines
7.6 KiB
Markdown
# v7.0.0
|
|
|
|
## Why v7?
|
|
|
|
This release represents a significant shift in how the project is maintained. Previously, adding a new app meant manually editing `applications.json`, copying boilerplate Obtainium settings, and hoping you didn't introduce a typo that would silently break things.
|
|
|
|
With v7, the tooling does the heavy lifting:
|
|
|
|
- **`make add-app`** turns a 5-minute manual process into a 30-second interactive prompt. Paste a URL, pick a category, done. No more copy-pasting JSON blocks or remembering which meta fields control which behavior.
|
|
- **`make validate`** catches mistakes before they ship. Typos in meta keys, missing required fields, duplicate app IDs—all caught at build time instead of discovered by users.
|
|
- **Refactored codebase** means less duplicated logic across scripts, making future changes easier and less error-prone.
|
|
|
|
The jump from v6 to v7 reflects that this isn't just a patch—it's a foundation for faster, more reliable releases going forward.
|
|
|
|
## Summary
|
|
|
|
- Refactored Python scripts to reduce duplication and improve maintainability
|
|
- Added `make add-app` interactive CLI for quickly adding new apps
|
|
- Added `make validate` to catch schema errors and typos before release
|
|
- Rewrote developer documentation with step-by-step guides
|
|
- Added PICO-8 Android to the app list
|
|
|
|
## New Features
|
|
|
|
### `make add-app` - Interactive CLI
|
|
|
|
Quickly add new apps without manually editing JSON:
|
|
|
|
- Auto-detects source type (GitHub, GitLab, Codeberg) from URL
|
|
- Auto-fills author and app name from GitHub URLs
|
|
- Arrow-key navigation for category and variant selection
|
|
- Variant options: Both, Standard only, Dual-screen only, README only
|
|
|
|
### `make validate` - JSON Validation
|
|
|
|
Catches common mistakes before they hit production:
|
|
|
|
- Schema validation (required fields, correct types)
|
|
- Typo detection in meta keys (e.g., `exludeFromExport` → `excludeFromExport`)
|
|
- Duplicate app ID detection per variant
|
|
|
|
## Code Changes
|
|
|
|
### New Files
|
|
|
|
- `scripts/utils.py` - Shared functions (`should_include_app`, `get_display_name`, `get_application_url`)
|
|
- `scripts/constants.py` - Centralized paths and Obtainium settings
|
|
- `scripts/validate-json.py` - Validation script
|
|
- `scripts/add-app.py` - Interactive CLI tool
|
|
|
|
### Refactored
|
|
|
|
- All Python scripts now have type hints
|
|
- All scripts have `if __name__ == "__main__"` guards (importable as modules)
|
|
- Removed duplicated logic across scripts
|
|
|
|
### Documentation
|
|
|
|
- Complete rewrite of `pages/development.md`
|
|
- Added project structure diagram
|
|
- Added meta field and categories reference tables
|
|
- Added pre-commit checklist
|
|
|
|
## New App
|
|
|
|
| Application Name | Add to Obtainium | Included in export json? | Included in DS json? |
|
|
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------ | -------------------- |
|
|
| <a href="https://github.com/Macs75/pico8-android">Pico8 Android</a> | <a href="http://apps.obtainium.imranr.dev/redirect.html?r=obtainium://app/%7B%22id%22%3A%22io.wip.pico8%22%2C%22url%22%3A%22https%3A%2F%2Fgithub.com%2FMacs75%2Fpico8-android%22%2C%22author%22%3A%22Macs75%22%2C%22name%22%3A%22Pico8%20Android%22%2C%22otherAssetUrls%22%3Anull%2C%22apkUrls%22%3Anull%2C%22preferredApkIndex%22%3A0%2C%22additionalSettings%22%3A%22%7B%5C%22includePrereleases%5C%22%3Afalse%2C%5C%22fallbackToOlderReleases%5C%22%3Atrue%2C%5C%22filterReleaseTitlesByRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22filterReleaseNotesByRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22verifyLatestTag%5C%22%3Afalse%2C%5C%22sortMethodChoice%5C%22%3A%5C%22date%5C%22%2C%5C%22useLatestAssetDateAsReleaseDate%5C%22%3Afalse%2C%5C%22releaseTitleAsVersion%5C%22%3Afalse%2C%5C%22trackOnly%5C%22%3Afalse%2C%5C%22versionExtractionRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22matchGroupToUse%5C%22%3A%5C%22%5C%22%2C%5C%22versionDetection%5C%22%3Atrue%2C%5C%22releaseDateAsVersion%5C%22%3Afalse%2C%5C%22useVersionCodeAsOSVersion%5C%22%3Afalse%2C%5C%22apkFilterRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22invertAPKFilter%5C%22%3Afalse%2C%5C%22autoApkFilterByArch%5C%22%3Atrue%2C%5C%22appName%5C%22%3A%5C%22%5C%22%2C%5C%22appAuthor%5C%22%3A%5C%22%5C%22%2C%5C%22shizukuPretendToBeGooglePlay%5C%22%3Afalse%2C%5C%22allowInsecure%5C%22%3Afalse%2C%5C%22exemptFromBackgroundUpdates%5C%22%3Afalse%2C%5C%22skipUpdateNotifications%5C%22%3Afalse%2C%5C%22about%5C%22%3A%5C%22%5C%22%2C%5C%22refreshBeforeDownload%5C%22%3Afalse%7D%22%2C%22categories%22%3A%5B%22Emulator%22%5D%2C%22overrideSource%22%3A%22GitHub%22%2C%22allowIdChange%22%3Anull%7D">Add to Obtainium!</a> | ✅ | ✅ |
|