@@ -38,12 +38,14 @@ Required secrets configured in GitHub Actions:
3838### Publishing Process
3939
40401 . Create and push a version tag:
41+
4142 ``` bash
42- git tag v0.2 .0
43- git push origin v0.2 .0
43+ git tag v0.3 .0
44+ git push origin v0.3 .0
4445 ```
4546
46472 . GitHub Actions automatically:
48+
4749 - Validates formatting with Spotless
4850 - Runs unit tests
4951 - Builds library AAR and example APKs
@@ -94,6 +96,7 @@ Required secrets configured in GitHub Actions:
9496### Build Configuration
9597
9698Publishing configuration is defined in:
99+
97100- ` build.gradle.kts ` (root) - nmcp plugin configuration
98101- ` openmapview/build.gradle.kts ` - Maven publication setup (POM metadata, signing)
99102- ` .github/workflows/release.yml ` - Release automation
@@ -111,12 +114,14 @@ Publishing configuration is defined in:
111114JitPack builds automatically from GitHub releases on first request:
112115
1131161 . Create and push a version tag:
117+
114118 ``` bash
115- git tag v0.2 .0
116- git push origin v0.2 .0
119+ git tag v0.3 .0
120+ git push origin v0.3 .0
117121 ```
118122
1191232 . JitPack automatically:
124+
120125 - Detects the new tag
121126 - Builds artifacts when first requested
122127 - Caches for subsequent requests
@@ -148,11 +153,12 @@ implementation("com.github.afarber:OpenMapView:feature-branch-SNAPSHOT")
148153
149154OpenMapView uses Semantic Versioning (SemVer):
150155
151- - ** vMAJOR.MINOR.PATCH** (e.g., ` v0.2 .0 ` )
156+ - ** vMAJOR.MINOR.PATCH** (e.g., ` v0.3 .0 ` )
152157- Version is automatically detected from Git tags
153158- Tags must match the pattern ` v*.*.* ` to trigger release workflow
154159
155160Examples:
161+
156162- ` v0.1.0 ` - Initial release
157163- ` v0.2.0 ` - New features added
158164- ` v0.2.1 ` - Bug fixes
@@ -166,7 +172,7 @@ When creating a new release:
166172- [ ] Run code formatting: ` ./gradlew spotlessApply `
167173- [ ] Verify local build: ` ./gradlew build `
168174- [ ] Test Maven publication: ` ./gradlew publishToMavenLocal `
169- - [ ] Create and push version tag (e.g., ` v0.2 .0 ` )
175+ - [ ] Create and push version tag (e.g., ` v0.3 .0 ` )
170176- [ ] Monitor GitHub Actions release workflow
171177- [ ] Verify Maven Central publication (10-30 minutes)
172178- [ ] Verify JitPack build status
@@ -178,19 +184,22 @@ When creating a new release:
178184** Issue: Workflow fails with "401 Unauthorized"**
179185
180186Solution: Verify GitHub Secrets are correctly configured:
187+
181188- Generate new tokens at https://central.sonatype.com/account
182189- Update ` OSSRH_USERNAME ` and ` OSSRH_PASSWORD ` secrets
183190
184191** Issue: "Failed to verify signature"**
185192
186193Solution: Verify GPG key configuration:
194+
187195- Confirm public key ` 8334881A009EB69E5B5BDBF189999F05686CE169 ` is published to keyservers
188196- Check ` SIGNING_KEY ` secret contains the full base64 private key
189197- Verify ` SIGNING_PASSWORD ` matches the GPG key passphrase
190198
191199** Issue: Version conflict**
192200
193201Solution: Maven Central does not allow republishing the same version:
202+
194203``` bash
195204git tag -d v0.1.0
196205git push origin :refs/tags/v0.1.0
@@ -205,13 +214,15 @@ git push origin v0.1.1
205214Solution: Check build logs at https://jitpack.io/#afarber/OpenMapView
206215
207216Common causes:
217+
208218- Missing ` jitpack.yml ` with correct JDK version
209219- Build configuration errors in ` build.gradle.kts `
210220- Missing dependencies or plugins
211221
212222** Issue: Build succeeds but artifact is empty**
213223
214224Solution: Verify ` maven-publish ` plugin is correctly configured:
225+
215226``` bash
216227./gradlew publishToMavenLocal
217228ls ~ /.m2/repository/de/afarber/openmapview/
@@ -220,6 +231,7 @@ ls ~/.m2/repository/de/afarber/openmapview/
220231** Issue: Artifact not found**
221232
222233Solution:
234+
223235- Ensure repository is public on GitHub
224236- Verify tag/release exists: ` git tag -l `
225237- Check artifact coordinates are correct (case-sensitive)
@@ -274,16 +286,19 @@ The release process is orchestrated by reusable GitHub Actions workflows:
274286## Resources
275287
276288### Maven Central
289+
277290- Central Portal: https://central.sonatype.com/
278291- Publishing Guide: https://central.sonatype.org/publish/publish-portal-gradle/
279292- Maven Repository: https://repo1.maven.org/maven2/
280293
281294### JitPack
295+
282296- Website: https://jitpack.io/
283297- Documentation: https://docs.jitpack.io/
284298- Android Guide: https://docs.jitpack.io/android/
285299
286300### Project Resources
301+
287302- GitHub Repository: https://github.com/afarber/OpenMapView
288303- Issue Tracker: https://github.com/afarber/OpenMapView/issues
289304- GitHub Actions: https://github.com/afarber/OpenMapView/actions
@@ -318,8 +333,8 @@ GitHub Actions workflow uses: `./gradlew publishAggregationToCentralPortal`
318333
319334``` bash
320335# Create a release
321- git tag v0.2 .0
322- git push origin v0.2 .0
336+ git tag v0.3 .0
337+ git push origin v0.3 .0
323338
324339# Check workflow status
325340# Visit: https://github.com/afarber/OpenMapView/actions
0 commit comments