Repository navigation
FileKit 0.17.1 is a patch release with bug fixes, a small web addition and a docs refresh.
Web apps can now turn a browser Blob or File into a PlatformFile. This release also fixes the file saver title on Windows and MIME type parameter parsing, and makes opening files with the default application more reliable on Linux desktops.
✨ What's New
- Add
PlatformFile(blob, name)on JS and Wasm to create aPlatformFilefrom a browserBloborFile, for example from drag and drop orfetch. It keeps the MIME type, and aFilekeeps itslastModified(closes #173). By @leitingzi in #703 (docs)
✅ Improvements
- JVM
FileKit.openFileWithDefaultApplicationnow checks thatjava.awt.Desktopcan open files, falls back toxdg-openon Linux, and throwsFileKitDialogExceptionwhen neither works, by @vinceglb in #700 - Remove
FileKitFileSaverWithoutBytesExceptionon web: it was public but never thrown, by @vinceglb in #700 - The sample apps use the FileKit brand, and the live web demo is deployed again, by @vinceglb in #698 and #694
🐛 Bug Fixes
- Apply
FileKitDialogSettings.titleto the file saver on JVM Windows, which always showed the default "Save As" title (fixes #707) by @vinceglb in #715 - Fix
MimeType.parsereplacing every parameter value with its name (text/plain; charset=UTF-8gavecharset=charset). This also fixesMimeType.toString(), equality between MIME types that differ by a parameter value, and the MIME type used when copying into an Android bookmarked directory, by @vinceglb in #716
📝 Documentation
- Restructure the docs for a faster first success, with new Platform support and AI assistants pages, by @vinceglb in #693
- Document the Mac App Store and TestFlight setup for sandboxed apps that crash when JNA loads its native library (closes #158) by @vinceglb in #717
- Embed the live demo in the docs, apply the FileKit brand to the docs site, and add the Showcase and Wall of love pages, by @vinceglb in #694, #699 and #702
- Add a contributing guide, issue forms and a pull request template by @vinceglb in #691
- Mention the Kotlin Foundation grant in the README and docs by @vinceglb in #708
⬆️ Dependency Updates
- Gradle
9.8.2→9.9.1 - Android Gradle Plugin
9.4.1→9.5.1 - kotlinx-serialization
1.12.0→1.13.0 - kotlinx-io
0.9.1→0.9.3 - Robolectric
4.17→4.18(tests only)
⚠️ Migration Notes
- Removed
FileKitFileSaverWithoutBytesException(web). It was never thrown, so only code that references the class by name is affected: delete those references. - JVM
openFileWithDefaultApplicationcan now throwFileKitDialogExceptionwhen the desktop can't open files, where it used to throwHeadlessExceptionorUnsupportedOperationException. On Linux, it triesxdg-openfirst. MimeTypeparameters now hold their real values, trimmed and lowercased (charset=utf-8). Code that worked around the oldcharset=charsetoutput can drop that workaround.
🙏 Contributors
Thanks a lot to @leitingzi for bringing Blob support to the web, and welcome to FileKit ❤️
Thanks also to @bfovez for the detailed Windows report in #707, to @ApoloApps for proposing Blob support in #173, and to @bartwell and @yannickpulver for the report and the solution in #158.
New Contributors
- @leitingzi made their first contribution in #703
Full Changelog: 0.17.0...0.17.1