From ba06e8637ffa4e97b55312e27e3bf869bc9356a7 Mon Sep 17 00:00:00 2001 From: Andreas Stefl Date: Mon, 3 Aug 2026 21:10:58 +0200 Subject: [PATCH] Keep a changelog on main and the store copy in fastlane The changelog records what changed, which is a property of the commits, so it belongs beside them: an entry goes in under Unreleased in the pull request that causes it, reviewed with its own diff. Cutting a release renames that heading and adds the compare link. Nothing in the build reads the file, so project.pbxproj keeps its 0.0.0 and the version still comes from the tag. The "What's New" text is a different thing in a different register, written for users of the app rather than for this repository, so it moves out to one file per marketing version under fastlane/metadata/en-US/changelogs/, mirroring OpenDocument.droid. The mirror is not exact, and the README there says why. On droid, supply reads that directory and Play keeps every version's notes; on iOS, deliver reads a single release_notes.txt per locale and App Store Connect keeps only the notes for the submission in flight. So here the directory is the history the store does not keep, and the notes are pasted in by hand at submission time, which leaves promoting a build the deliberate step it already was. skip_metadata stays true and no upload path changes. Named by marketing version rather than build number: the build number is a live query of what TestFlight already has, so it is not known until a release run starts and cannot name a file committed ahead of it. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01SUuHL6wPM5TpDsrFxW9fH9 --- CHANGELOG.md | 83 ++++++++++++++++++++ fastlane/metadata/en-US/changelogs/1.35.txt | 5 ++ fastlane/metadata/en-US/changelogs/1.36.txt | 9 +++ fastlane/metadata/en-US/changelogs/1.37.txt | 1 + fastlane/metadata/en-US/changelogs/README.md | 23 ++++++ 5 files changed, 121 insertions(+) create mode 100644 CHANGELOG.md create mode 100644 fastlane/metadata/en-US/changelogs/1.35.txt create mode 100644 fastlane/metadata/en-US/changelogs/1.36.txt create mode 100644 fastlane/metadata/en-US/changelogs/1.37.txt create mode 100644 fastlane/metadata/en-US/changelogs/README.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..2e62233 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,83 @@ +# Changelog + +User-facing changes to OpenDocument Reader for iOS. Changes to the shared +OpenDocument core that the app picked up are listed under the release that +shipped them. + +The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). + +Entries go under `Unreleased` as the change lands, in the same pull request. +Cutting a release renames that heading to the version and adds its compare +link; nothing in the build reads this file, so `project.pbxproj` keeps its +`0.0.0` and the version still comes from the tag. + +The copy that App Store Connect shows under "What's New" is a different, shorter +register, and lives in `fastlane/metadata/en-US/changelogs/.txt`. It is +pasted into App Store Connect at submission time; see the README there. + +## [Unreleased] + +## [1.37] - 2026-08-02 + +No user-facing changes. This release only changes how the app is built and +submitted. + +## [1.36] - 2026-08-02 + +### Added + +- Legacy Microsoft formats (.doc, .xls, .ppt) are read by our own + implementation: character formatting, cell fonts and fills, embedded + pictures, real slide sizes and slide names. +- OOXML documents: PowerPoint slide size and tables, Excel merged cells and + value types, Word table merges and line breaks. +- ODF documents: subscript and superscript, percentage line height, first-line + indent. +- Documents with fixed-size content open fit-to-width on phones. + +### Changed + +- Requires iOS 15 or later. +- The app no longer collects analytics and no longer reports crashes. All + Firebase components were removed. +- Pages are rendered when you open them instead of all at once. Documents with + many pages, slides or sheets open faster, and switching between them no + longer re-reads the file. +- The page tabs were rewritten: they follow light and dark appearance, each tab + takes only the width of its own title so one long sheet name no longer pushes + the others off screen, and they are reachable with VoiceOver. +- File type detection is more reliable, so documents with a wrong or missing + extension open more often. + +### Fixed + +- Failures are reported instead of ending the app. Documents where no page + could be shown, failed imports and a few other states previously crashed. +- Saving an edited document no longer stalls for 30 seconds when the save + fails; the error is reported right away. +- Word documents: line breaks inside paragraphs are kept. +- PowerPoint documents: read-only files are reported as read-only, and text + split across several runs is no longer broken apart. + +## [1.35] - 2025-06-12 + +### Added + +- Support for the newer ODF encryption scheme, so encrypted documents that + previously failed to open now open. +- Documents follow the system light and dark appearance. + +### Changed + +- Colors in OOXML documents are closer to the original. +- General improvements to page styling. + +### Fixed + +- An incorrect password is now reported as such instead of a generic failure. +- Page handling and decryption fixes when opening protected documents. + +[Unreleased]: https://github.com/opendocument-app/OpenDocument.ios/compare/1.37...HEAD +[1.37]: https://github.com/opendocument-app/OpenDocument.ios/compare/1.36...1.37 +[1.36]: https://github.com/opendocument-app/OpenDocument.ios/compare/1.35...1.36 +[1.35]: https://github.com/opendocument-app/OpenDocument.ios/compare/1.34...1.35 diff --git a/fastlane/metadata/en-US/changelogs/1.35.txt b/fastlane/metadata/en-US/changelogs/1.35.txt new file mode 100644 index 0000000..269777e --- /dev/null +++ b/fastlane/metadata/en-US/changelogs/1.35.txt @@ -0,0 +1,5 @@ +- Support for the newer ODF encryption scheme +- Documents follow the system light and dark appearance +- More accurate colors in Word, Excel and PowerPoint documents +- An incorrect password is now reported as such +- Fixes for page handling and decryption of protected documents diff --git a/fastlane/metadata/en-US/changelogs/1.36.txt b/fastlane/metadata/en-US/changelogs/1.36.txt new file mode 100644 index 0000000..f8b4ec7 --- /dev/null +++ b/fastlane/metadata/en-US/changelogs/1.36.txt @@ -0,0 +1,9 @@ +- Legacy Word, Excel and PowerPoint files (.doc, .xls, .ppt) are read by our own implementation, with character formatting, cell fonts and fills, pictures, slide sizes and slide names +- Better support for Word tables and line breaks, Excel merged cells and value types, and PowerPoint slide sizes and tables +- ODF documents: subscript and superscript, percentage line height, first-line indent +- Pages are rendered when you open them, so documents with many pages, slides or sheets open faster +- Rewritten page tabs: readable in dark mode, no longer pushed off screen by a long sheet name, and usable with VoiceOver +- More reliable file type detection +- The app no longer collects analytics and no longer reports crashes +- Several crashes fixed, and failures are now reported instead of ending the app +- Requires iOS 15 or later diff --git a/fastlane/metadata/en-US/changelogs/1.37.txt b/fastlane/metadata/en-US/changelogs/1.37.txt new file mode 100644 index 0000000..1ccba54 --- /dev/null +++ b/fastlane/metadata/en-US/changelogs/1.37.txt @@ -0,0 +1 @@ +This release only changes how the app is built and submitted. There are no changes to the app itself. diff --git a/fastlane/metadata/en-US/changelogs/README.md b/fastlane/metadata/en-US/changelogs/README.md new file mode 100644 index 0000000..37b16af --- /dev/null +++ b/fastlane/metadata/en-US/changelogs/README.md @@ -0,0 +1,23 @@ +# Release notes + +One file per marketing version, holding the "What's New" text for that +submission. Written for users of the app, not for this repository: the +developer-facing record of the same release is in `CHANGELOG.md` at the root. + +Named by marketing version (`1.37.txt`), not by build number. The build number +is a live query of what TestFlight already has, so it is not known until a +release run starts and cannot name a file committed ahead of it. + +`deliver` does not read this directory. It reads one file per locale, +`fastlane/metadata//release_notes.txt`, and the upload skips metadata +entirely (`skip_metadata: true` in `fastlane/Fastfile`), because promoting a +build is a deliberate step in App Store Connect rather than something a tag +push does. So the notes for a release are pasted into App Store Connect by +hand, from the file for that version. + +App Store Connect keeps only the notes for the version being submitted, so +these files are the history that the store does not keep. The limit is 4000 +characters. + +Only en-US is kept, matching OpenDocument.droid. Other locales fall back to the +English text in the store.