PasteFerry (隔空贴): clipboard and file sync across macOS, Windows and Linux. Direct-first, end-to-end encrypted. Optional official access: no server to host. Independent self-hosting remains available.
Dart airdrop-alternativeclipboardclipboard-sharingclipboard-synccopy-pastecross-platformend-to-end-encryptionfile-syncfile-transferfluttergolanglinuxmacosnat-traversalp2pself-hostedtailscaleuniversal-clipboardwebrtcwindows
fix(ui): support Android 9 in the arm64 APK
baiyuzee94cac51d27f
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.ymlindex 5177ade..6291652 100644--- a/.github/workflows/ci.yml+++ b/.github/workflows/ci.yml@@ -151,6 +151,9 @@ jobs:ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}ANDROID_KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}+ - name: Android compatibility tests and API checks+ run: ./gradlew :app:testDebugUnitTest :app:lintRelease+ working-directory: ui/android- uses: actions/upload-artifact@v4with:name: PasteFerry-androiddiff --git a/client-core/mobile/mobile.go b/client-core/mobile/mobile.goindex 85d349f..6d47522 100644--- a/client-core/mobile/mobile.go+++ b/client-core/mobile/mobile.go@@ -1,7 +1,7 @@// Package mobile 是 Android App 内嵌的 Go 核心(design/phone-sync.md 3.3.1、3.3.2 节),// 用 gomobile bind 导出给 Kotlin://-// gomobile bind -target=android/arm64 -androidapi 29 -ldflags=-checklinkname=0 ./mobile(见 scripts/build-android.sh)+// gomobile bind -target=android/arm64 -androidapi 28 -ldflags=-checklinkname=0 ./mobile(见 scripts/build-android.sh)//// 组装方式与桌面的 cmd/pasteferryd 相同,只是:// - 只开局域网通道(服务模式固定为 lan),不连服务器;diff --git a/design/phone-sync.md b/design/phone-sync.mdindex f1bf315..f46349b 100644--- a/design/phone-sync.md+++ b/design/phone-sync.md@@ -51,7 +51,7 @@1. 一期只做局域网。2. 先做网页传输,再做 Android App。3. iOS 暂不做,iPhone 用户先用网页传输。-4. Android 最低支持 Android 10(3.3.8 节)。+4. Android 最低支持 Android 9(3.3.8 节)。5. 网页传输在网页里自己加密内容,不用明文 http。6. Android 一期:文字自动写进手机剪贴板;图片和文件点了才放进剪贴板;手机在发送页发文字。7. Android 支持扫码配对:扫电脑上的二维码,不用核对指纹,电脑上点一次确认(3.3.9 节)。@@ -500,17 +500,17 @@ Kotlin 宿主| 项 | 取值 | 理由 ||---|---|---|-| minSdk | **29(Android 10)** | 见下 |+| minSdk | **28(Android 9)** | App 与 gomobile 核心同时使用 API 28,同一个 arm64 APK 支持 Android 9 及以上 || targetSdk / compileSdk | 36 | 本机 Flutter 3.44.9 的默认值;不用申请局域网权限(3.3.5 节) || CPU 架构 | arm64-v8a | 32 位的 armeabi-v7a 等内测反馈再决定要不要加;模拟器另编 x86_64 |-为什么是 Android 10:+2.7.3 起从 Android 10 下放到 Android 9,不需要另出兼容 APK:-- **覆盖面**:Flutter 3.44.9 最低能到 Android 7.0(API 24)。按 [apilevels.com](https://apilevels.com/)(StatCounter 2026 年 4 月的全球数据),Android 10 及以上约占 91.1%,7.0 及以上约 96.6%,往下放只多覆盖约 5.5 个百分点。国内的分布可能不同,没有找到可靠数据。-- **代码路径**:- - 前台服务的 `foregroundServiceType`(包括 `connectedDevice`)从 Android 10 起才有;- - 不申请存储权限就能用 MediaStore 存进「下载」目录,也是 Android 10 起;- - 剪贴板的后台读取限制同样从 Android 10 开始,各版本行为一致,测试矩阵也小。+- Flutter、Go 核心与现有插件支持 API 28。前台服务经 `ServiceCompat` 在 Android 9 调用不带类型的系统接口。+- Android 9 只在点击「保存」时申请存储权限;允许后写入公共 Pictures/PasteFerry 或 Download/PasteFerry,图片通知媒体库收录。拒绝则说明原因并保留重试入口,同名文件另存而不覆盖。+- Android 10 及以上继续经 MediaStore 保存,不申请旧版存储权限;权限声明限定 `maxSdkVersion=28`。+- Android 9 也保持由用户在发送页粘贴并发送,不额外增加后台剪贴板读取。+- `FileSaverTest` 用 API 28 / 29 验证授权边界、保存、目录结构和同名文件保护;CI 同时运行 Android lint 检查高版本 API 的使用。- **鸿蒙**:鸿蒙 2–4 的华为手机能装 APK(**待真机验证**);鸿蒙 NEXT 不能。#### 3.3.9 扫码配对diff --git a/scripts/build-android.sh b/scripts/build-android.shindex dc102f1..856d609 100755--- a/scripts/build-android.sh+++ b/scripts/build-android.sh@@ -2,7 +2,7 @@# 构建 Android App(design/phone-sync.md 3.3.7 节):先用 gomobile 把 Go 核心打成 AAR,再由 Flutter 打 APK。## ./scripts/build-android.sh # arm64 的 APK,在 ui/build/app/outputs/flutter-apk/app-release.apk-# # (不放进 release/:那里只放 Release 的 14 个附件)+# # (发版时另存为 release/PasteFerry-android-arm64.apk)# ./scripts/build-android.sh --aar # 只打 AAR,之后可以 flutter run --target-platform android-arm64 调试# ./scripts/build-android.sh --aar --emulator # 给 x86_64 模拟器调试用的 AAR,见下面 --emulator 的说明#@@ -75,7 +75,7 @@ mkdir -p ui/android/app/libs# -checklinkname=0:pion 的间接依赖 wlynxg/anet 用了 go:linkname(3.3.2 节第 2 条)(cd client-core && gomobile bind \-target=android/arm64 \- -androidapi 29 \+ -androidapi 28 \-javapkg=com.pasteferry.core \-ldflags="-checklinkname=0 -s -w" \-o ../ui/android/app/libs/pasteferry-core.aar \diff --git a/ui/android/.gitignore b/ui/android/.gitignoreindex 8dc1c6f..d20e0f3 100644--- a/ui/android/.gitignore+++ b/ui/android/.gitignore@@ -1,5 +1,6 @@gradle-wrapper.jar/.gradle+/.kotlin//captures//gradlew/gradlew.batdiff --git a/ui/android/app/build.gradle.kts b/ui/android/app/build.gradle.ktsindex 92b87fe..ca65289 100644--- a/ui/android/app/build.gradle.kts+++ b/ui/android/app/build.gradle.kts@@ -6,7 +6,7 @@ plugins {android {namespace = "com.pasteferry.app"- // design/phone-sync.md 3.3.8 节:Android 10 起;target 36 不用申请 Android 17 的局域网权限+ // Android 9 起;target 36 不用申请 Android 17 的局域网权限compileSdk = 36ndkVersion = flutter.ndkVersion@@ -17,7 +17,7 @@ android {defaultConfig {applicationId = "com.pasteferry.app"- minSdk = 29+ minSdk = 28targetSdk = 36versionCode = flutter.versionCodeversionName = flutter.versionName@@ -31,6 +31,10 @@ android {signingConfig = signingConfigs.getByName("debug")}}++ testOptions {+ unitTests.isIncludeAndroidResources = true+ }}kotlin {@@ -47,4 +51,6 @@ dependencies {// Go 核心,由 scripts/build-android.sh 用 gomobile bind 生成,不进版本库implementation(files("libs/pasteferry-core.aar"))implementation("androidx.core:core-ktx:1.17.0")+ testImplementation("junit:junit:4.13.2")+ testImplementation("org.robolectric:robolectric:4.16.1")}diff --git a/ui/android/app/src/main/AndroidManifest.xml b/ui/android/app/src/main/AndroidManifest.xmlindex bc34339..4dd7a73 100644--- a/ui/android/app/src/main/AndroidManifest.xml+++ b/ui/android/app/src/main/AndroidManifest.xml@@ -9,6 +9,8 @@<uses-permission android:name="android.permission.FOREGROUND_SERVICE_CONNECTED_DEVICE" /><uses-permission android:name="android.permission.POST_NOTIFICATIONS" /><uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />+ <!-- Android 9 保存到相册/下载目录时按需申请;Android 10+ 使用 MediaStore,无需此权限 -->+ <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" /><applicationandroid:label="@string/app_name"diff --git a/ui/android/app/src/main/kotlin/com/pasteferry/app/FileSaver.kt b/ui/android/app/src/main/kotlin/com/pasteferry/app/FileSaver.ktnew file mode 100644index 0000000..26fff3c--- /dev/null+++ b/ui/android/app/src/main/kotlin/com/pasteferry/app/FileSaver.kt@@ -0,0 +1,90 @@+package com.pasteferry.app++import android.Manifest+import android.content.ContentValues+import android.content.Context+import android.content.pm.PackageManager+import android.media.MediaScannerConnection+import android.os.Build+import android.os.Environment+import android.provider.MediaStore+import android.webkit.MimeTypeMap+import androidx.annotation.RequiresApi+import java.io.File+import java.io.IOException++/** Android 9 使用按需授权的公共目录;Android 10+ 使用无需存储权限的 MediaStore。 */+internal class FileSaver(private val context: Context) {+ fun needsStoragePermission(): Boolean =+ Build.VERSION.SDK_INT < Build.VERSION_CODES.Q &&+ context.checkSelfPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED++ fun save(paths: List<String>): Int {+ var n = 0+ for (path in paths) {+ val f = File(path)+ val files = if (f.isDirectory) f.walkTopDown().filter { it.isFile }.toList() else listOf(f)+ for (file in files) {+ val sub = if (f.isDirectory) file.parentFile!!.relativeTo(f.parentFile!!).path else ""+ if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) saveScoped(file, sub)+ else saveLegacy(file, sub)+ n+++ }+ }+ return n+ }++ @RequiresApi(Build.VERSION_CODES.Q)+ private fun saveScoped(file: File, sub: String) {+ val mime = mimeOf(file)+ val image = mime.startsWith("image/")+ val collection = if (image) MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY)+ else MediaStore.Downloads.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY)+ val dir = (if (image) "Pictures/PasteFerry" else "Download/PasteFerry") + (if (sub.isEmpty()) "" else "/$sub")+ val values = ContentValues().apply {+ put(MediaStore.MediaColumns.DISPLAY_NAME, file.name)+ put(MediaStore.MediaColumns.MIME_TYPE, mime)+ put(MediaStore.MediaColumns.RELATIVE_PATH, dir)+ put(MediaStore.MediaColumns.IS_PENDING, 1)+ }+ val resolver = context.contentResolver+ val uri = resolver.insert(collection, values) ?: throw IOException("Cannot save ${file.name}")+ try {+ val out = resolver.openOutputStream(uri) ?: throw IOException("Cannot open ${file.name}")+ out.use { file.inputStream().use { input -> input.copyTo(it) } }+ resolver.update(uri, ContentValues().apply { put(MediaStore.MediaColumns.IS_PENDING, 0) }, null, null)+ } catch (e: Exception) {+ resolver.delete(uri, null, null)+ throw e+ }+ }++ @Suppress("DEPRECATION")+ private fun saveLegacy(file: File, sub: String) {+ // 即使宿主忘记授权,也不能绕过用户选择去写公共目录。+ if (needsStoragePermission()) throw SecurityException(context.getString(R.string.save_storage_permission))+ val mime = mimeOf(file)+ val collection = if (mime.startsWith("image/")) Environment.DIRECTORY_PICTURES else Environment.DIRECTORY_DOWNLOADS+ val root = File(Environment.getExternalStoragePublicDirectory(collection), "PasteFerry")+ val dir = if (sub.isEmpty()) root else File(root, sub)+ if (!dir.mkdirs() && !dir.isDirectory) throw IOException("Cannot create ${dir.path}")+ var output = File(dir, file.name)+ var suffix = 1+ while (!output.createNewFile()) {+ val ext = file.extension.let { if (it.isEmpty()) "" else ".$it" }+ output = File(dir, "${file.nameWithoutExtension} (${suffix++})$ext")+ }+ try {+ output.outputStream().use { out -> file.inputStream().use { it.copyTo(out) } }+ MediaScannerConnection.scanFile(context, arrayOf(output.absolutePath), arrayOf(mime), null)+ } catch (e: Exception) {+ output.delete()+ throw e+ }+ }++ companion object {+ fun mimeOf(f: File): String =+ MimeTypeMap.getSingleton().getMimeTypeFromExtension(f.extension.lowercase()) ?: "application/octet-stream"+ }+}diff --git a/ui/android/app/src/main/kotlin/com/pasteferry/app/MainActivity.kt b/ui/android/app/src/main/kotlin/com/pasteferry/app/MainActivity.ktindex ed29825..611b92b 100644--- a/ui/android/app/src/main/kotlin/com/pasteferry/app/MainActivity.kt+++ b/ui/android/app/src/main/kotlin/com/pasteferry/app/MainActivity.kt@@ -2,7 +2,6 @@ package com.pasteferry.appimport android.Manifestimport android.annotation.SuppressLint-import android.content.ContentValuesimport android.content.Intentimport android.content.pm.PackageManagerimport android.net.ConnectivityManager@@ -10,9 +9,7 @@ import android.net.NetworkCapabilitiesimport android.net.Uriimport android.os.Buildimport android.os.PowerManager-import android.provider.MediaStoreimport android.provider.Settings-import android.webkit.MimeTypeMapimport androidx.core.app.NotificationManagerCompatimport io.flutter.embedding.android.FlutterActivityimport io.flutter.embedding.engine.FlutterEngine@@ -28,6 +25,7 @@ import java.util.concurrent.Executorsclass MainActivity : FlutterActivity() {private val io = Executors.newSingleThreadExecutor()private var pendingNotification: MethodChannel.Result? = null+ private var pendingSave: Pair<List<String>, MethodChannel.Result>? = nulloverride fun configureFlutterEngine(flutterEngine: FlutterEngine) {super.configureFlutterEngine(flutterEngine)@@ -70,7 +68,7 @@ class MainActivity : FlutterActivity() {if (on) SyncService.start(this) else SyncService.stop(this)result.success(on)}- "save" -> background(result) { save(call.argument<List<String>>("paths")!!) }+ "save" -> save(call.argument<List<String>>("paths")!!, result)"share" -> {share(call.argument<List<String>>("paths")!!)result.success(null)@@ -113,40 +111,17 @@ class MainActivity : FlutterActivity() {// ─────────────── 保存与分享(3.3.3 节) ───────────────- /** 图片存进相册的 Pictures/PasteFerry,其他文件存进「下载」的 PasteFerry 文件夹。Android 10 起不需要存储权限。返回存下的个数 */- private fun save(paths: List<String>): Int {- var n = 0- for (path in paths) {- val f = File(path)- val files = if (f.isDirectory) f.walkTopDown().filter { it.isFile }.toList() else listOf(f)- for (file in files) {- val sub = if (f.isDirectory) file.parentFile!!.relativeTo(f.parentFile!!).path else ""- saveOne(file, sub)- n+++ /** Android 9 只在用户点击保存时申请存储权限;新系统不申请。 */+ private fun save(paths: List<String>, result: MethodChannel.Result) {+ if (FileSaver(this).needsStoragePermission()) {+ if (pendingSave != null) {+ result.error("busy", getString(R.string.save_permission_pending), null)+ return}- }- return n- }-- private fun saveOne(file: File, sub: String) {- val mime = mimeOf(file)- val image = mime.startsWith("image/")- val collection = if (image) MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY)- else MediaStore.Downloads.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY)- val dir = (if (image) "Pictures/PasteFerry" else "Download/PasteFerry") + (if (sub.isEmpty()) "" else "/$sub")- val values = ContentValues().apply {- put(MediaStore.MediaColumns.DISPLAY_NAME, file.name)- put(MediaStore.MediaColumns.MIME_TYPE, mime)- put(MediaStore.MediaColumns.RELATIVE_PATH, dir)- put(MediaStore.MediaColumns.IS_PENDING, 1)- }- val uri = contentResolver.insert(collection, values) ?: throw IllegalStateException("无法保存 ${file.name}")- try {- contentResolver.openOutputStream(uri)!!.use { out -> file.inputStream().use { it.copyTo(out) } }- contentResolver.update(uri, ContentValues().apply { put(MediaStore.MediaColumns.IS_PENDING, 0) }, null, null)- } catch (e: Exception) {- contentResolver.delete(uri, null, null)- throw e+ pendingSave = paths to result+ requestPermissions(arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE), REQUEST_STORAGE)+ } else {+ background(result) { FileSaver(this).save(paths) }}}@@ -154,7 +129,7 @@ class MainActivity : FlutterActivity() {val files = paths.map(::File).flatMap { if (it.isDirectory) it.walkTopDown().filter(File::isFile).toList() else listOf(it) }if (files.isEmpty()) returnval uris = ArrayList<Uri>(files.map { Core.uriFor(it.path) })- val mimes = files.map(::mimeOf).distinct()+ val mimes = files.map { FileSaver.mimeOf(it) }.distinct()val type = mimes.singleOrNull() ?: if (mimes.all { it.startsWith("image/") }) "image/*" else "*/*"val send = if (uris.size == 1) {Intent(Intent.ACTION_SEND).putExtra(Intent.EXTRA_STREAM, uris.first())@@ -165,9 +140,6 @@ class MainActivity : FlutterActivity() {startActivity(Intent.createChooser(send, getString(R.string.share_title)))}- private fun mimeOf(f: File): String =- MimeTypeMap.getSingleton().getMimeTypeFromExtension(f.extension.lowercase()) ?: "application/octet-stream"-// ─────────────── 权限与系统设置 ───────────────/** granted、denied(可以再请求)或 blocked(只能去系统设置里打开) */@@ -196,6 +168,16 @@ class MainActivity : FlutterActivity() {override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {super.onRequestPermissionsResult(requestCode, permissions, grantResults)+ if (requestCode == REQUEST_STORAGE) {+ val save = pendingSave ?: return+ pendingSave = null+ if (grantResults.firstOrNull() == PackageManager.PERMISSION_GRANTED) {+ background(save.second) { FileSaver(this).save(save.first) }+ } else {+ save.second.error("permission_denied", getString(R.string.save_storage_permission), null)+ }+ return+ }if (requestCode != REQUEST_NOTIFICATIONS) returnpendingNotification?.success(notificationState())pendingNotification = null@@ -226,5 +208,6 @@ class MainActivity : FlutterActivity() {companion object {private const val REQUEST_NOTIFICATIONS = 1+ private const val REQUEST_STORAGE = 2}}diff --git a/ui/android/app/src/main/res/values-ja/strings.xml b/ui/android/app/src/main/res/values-ja/strings.xmlindex bfe4d4b..5660c95 100644--- a/ui/android/app/src/main/res/values-ja/strings.xml+++ b/ui/android/app/src/main/res/values-ja/strings.xml@@ -9,4 +9,6 @@<string name="notif_last_image">最新:%1$s からの画像</string><string name="notif_last_file">最新:%1$s からのファイル</string><string name="share_title">共有</string>+ <string name="save_storage_permission">写真やファイルの保存にはストレージへのアクセス許可が必要です。もう一度「保存」を押して再試行してください。</string>+ <string name="save_permission_pending">先に現在のストレージの許可を完了してください。</string></resources>diff --git a/ui/android/app/src/main/res/values-zh-rHK/strings.xml b/ui/android/app/src/main/res/values-zh-rHK/strings.xmlindex cd70da2..b54e09b 100644--- a/ui/android/app/src/main/res/values-zh-rHK/strings.xml+++ b/ui/android/app/src/main/res/values-zh-rHK/strings.xml@@ -9,4 +9,6 @@<string name="notif_last_image">最近:來自 %1$s 的圖片</string><string name="notif_last_file">最近:來自 %1$s 的檔案</string><string name="share_title">分享</string>+ <string name="save_storage_permission">儲存圖片和檔案需要允許存取儲存空間。請再次按「儲存」重試。</string>+ <string name="save_permission_pending">請先完成目前的儲存空間授權。</string></resources>diff --git a/ui/android/app/src/main/res/values-zh-rTW/strings.xml b/ui/android/app/src/main/res/values-zh-rTW/strings.xmlindex cd70da2..4affb49 100644--- a/ui/android/app/src/main/res/values-zh-rTW/strings.xml+++ b/ui/android/app/src/main/res/values-zh-rTW/strings.xml@@ -9,4 +9,6 @@<string name="notif_last_image">最近:來自 %1$s 的圖片</string><string name="notif_last_file">最近:來自 %1$s 的檔案</string><string name="share_title">分享</string>+ <string name="save_storage_permission">儲存圖片和檔案需要允許存取儲存空間。請再次點選「儲存」重試。</string>+ <string name="save_permission_pending">請先完成目前的儲存空間授權。</string></resources>diff --git a/ui/android/app/src/main/res/values-zh/strings.xml b/ui/android/app/src/main/res/values-zh/strings.xmlindex 219d5e3..34230a9 100644--- a/ui/android/app/src/main/res/values-zh/strings.xml+++ b/ui/android/app/src/main/res/values-zh/strings.xml@@ -9,4 +9,6 @@<string name="notif_last_image">最近:来自 %1$s 的图片</string><string name="notif_last_file">最近:来自 %1$s 的文件</string><string name="share_title">分享</string>+ <string name="save_storage_permission">保存图片和文件需要允许存储访问。请再次点击“保存”重试。</string>+ <string name="save_permission_pending">请先完成当前的存储授权。</string></resources>diff --git a/ui/android/app/src/main/res/values/strings.xml b/ui/android/app/src/main/res/values/strings.xmlindex 9ec1484..29c495c 100644--- a/ui/android/app/src/main/res/values/strings.xml+++ b/ui/android/app/src/main/res/values/strings.xml@@ -9,4 +9,6 @@<string name="notif_last_image">Latest: image from %1$s</string><string name="notif_last_file">Latest: file from %1$s</string><string name="share_title">Share</string>+ <string name="save_storage_permission">Allow storage access to save photos and files. Tap Save again to try again.</string>+ <string name="save_permission_pending">Please finish the current storage permission request first.</string></resources>diff --git a/ui/android/app/src/test/kotlin/com/pasteferry/app/FileSaverTest.kt b/ui/android/app/src/test/kotlin/com/pasteferry/app/FileSaverTest.ktnew file mode 100644index 0000000..9855e5a--- /dev/null+++ b/ui/android/app/src/test/kotlin/com/pasteferry/app/FileSaverTest.kt@@ -0,0 +1,72 @@+package com.pasteferry.app++import android.Manifest+import android.app.Application+import android.os.Environment+import org.junit.Assert.*+import org.junit.Before+import org.junit.Test+import org.junit.runner.RunWith+import org.robolectric.RobolectricTestRunner+import org.robolectric.RuntimeEnvironment+import org.robolectric.Shadows.shadowOf+import org.robolectric.annotation.Config+import org.robolectric.shadows.ShadowEnvironment+import java.io.File++@RunWith(RobolectricTestRunner::class)+@Config(sdk = [28], application = Application::class)+class FileSaverTest {+ private val app: Application get() = RuntimeEnvironment.getApplication()+ private val saver get() = FileSaver(app)++ @Before+ fun mountedStorage() {+ ShadowEnvironment.setExternalStorageState(Environment.MEDIA_MOUNTED)+ }++ @Test+ fun android9NeedsPermissionAndDoesNotWriteWhenDenied() {+ shadowOf(app).denyPermissions(Manifest.permission.WRITE_EXTERNAL_STORAGE)+ assertTrue(saver.needsStoragePermission())+ val source = File(app.cacheDir, "denied.txt").apply { writeText("private") }+ assertThrows(SecurityException::class.java) { saver.save(listOf(source.path)) }+ assertFalse(File(downloads(), "denied.txt").exists())+ shadowOf(app).grantPermissions(Manifest.permission.WRITE_EXTERNAL_STORAGE)+ assertFalse(saver.needsStoragePermission())+ }++ @Test+ fun android9SavesFilesAndKeepsExistingFiles() {+ shadowOf(app).grantPermissions(Manifest.permission.WRITE_EXTERNAL_STORAGE)+ val source = File(app.cacheDir, "note.txt").apply { writeText("first") }+ assertEquals(1, saver.save(listOf(source.path)))+ source.writeText("second")+ assertEquals(1, saver.save(listOf(source.path)))+ assertEquals("first", File(downloads(), "note.txt").readText())+ assertEquals("second", File(downloads(), "note (1).txt").readText())+ }++ @Test+ fun android9SavesImagesInPicturesAndPreservesFolderStructure() {+ shadowOf(app).grantPermissions(Manifest.permission.WRITE_EXTERNAL_STORAGE)+ val folder = File(app.cacheDir, "trip")+ val photo = File(folder, "photos/photo.png").apply { parentFile!!.mkdirs(); writeBytes(byteArrayOf(1, 2, 3)) }+ val note = File(folder, "notes/readme.txt").apply { parentFile!!.mkdirs(); writeText("hello") }+ assertEquals(2, saver.save(listOf(folder.path)))+ val pictures = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES)+ assertArrayEquals(photo.readBytes(), File(pictures, "PasteFerry/trip/photos/photo.png").readBytes())+ assertEquals(note.readText(), File(downloads(), "trip/notes/readme.txt").readText())+ }++ @Test+ @Config(sdk = [29])+ fun android10DoesNotAskForLegacyStoragePermission() {+ shadowOf(app).denyPermissions(Manifest.permission.WRITE_EXTERNAL_STORAGE)+ assertFalse(saver.needsStoragePermission())+ }++ @Suppress("DEPRECATION")+ private fun downloads(): File =+ File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS), "PasteFerry")+}