Skip to content

Commit 10e4ee5

Browse files
committed
Use landscape mode
1 parent 8b7dd6f commit 10e4ee5

File tree

3 files changed

+24
-9
lines changed

3 files changed

+24
-9
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Add to your `build.gradle.kts`:
1414

1515
```kotlin
1616
dependencies {
17-
implementation("de.afarber:openmapview:0.2.0")
17+
implementation("de.afarber:openmapview:0.3.0")
1818
}
1919
```
2020

docs/PUBLISHING.md

Lines changed: 23 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -38,12 +38,14 @@ Required secrets configured in GitHub Actions:
3838
### Publishing Process
3939

4040
1. 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

4647
2. 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

9698
Publishing 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:
111114
JitPack builds automatically from GitHub releases on first request:
112115

113116
1. 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

119123
2. 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

149154
OpenMapView 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

155160
Examples:
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

180186
Solution: 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

186193
Solution: 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

193201
Solution: Maven Central does not allow republishing the same version:
202+
194203
```bash
195204
git tag -d v0.1.0
196205
git push origin :refs/tags/v0.1.0
@@ -205,13 +214,15 @@ git push origin v0.1.1
205214
Solution: Check build logs at https://jitpack.io/#afarber/OpenMapView
206215

207216
Common 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

214224
Solution: Verify `maven-publish` plugin is correctly configured:
225+
215226
```bash
216227
./gradlew publishToMavenLocal
217228
ls ~/.m2/repository/de/afarber/openmapview/
@@ -220,6 +231,7 @@ ls ~/.m2/repository/de/afarber/openmapview/
220231
**Issue: Artifact not found**
221232

222233
Solution:
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
9.27 MB
Loading

0 commit comments

Comments
 (0)