Skip to content

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.

fix(ui): support Android 9 in the arm64 APK

baiyuzee94cac51d27f
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 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@v4
with:
name: PasteFerry-android
diff --git a/client-core/mobile/mobile.go b/client-core/mobile/mobile.go
index 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.md
index 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.sh
index 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/.gitignore
index 8dc1c6f..d20e0f3 100644
--- a/ui/android/.gitignore
+++ b/ui/android/.gitignore
@@ -1,5 +1,6 @@
gradle-wrapper.jar
/.gradle
+/.kotlin/
/captures/
/gradlew
/gradlew.bat
diff --git a/ui/android/app/build.gradle.kts b/ui/android/app/build.gradle.kts
index 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 = 36
ndkVersion = flutter.ndkVersion
@@ -17,7 +17,7 @@ android {
defaultConfig {
applicationId = "com.pasteferry.app"
- minSdk = 29
+ minSdk = 28
targetSdk = 36
versionCode = flutter.versionCode
versionName = 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.xml
index 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" />
<application
android: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.kt
new file mode 100644
index 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.kt
index 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.app
import android.Manifest
import android.annotation.SuppressLint
-import android.content.ContentValues
import android.content.Intent
import android.content.pm.PackageManager
import android.net.ConnectivityManager
@@ -10,9 +9,7 @@ import android.net.NetworkCapabilities
import android.net.Uri
import android.os.Build
import android.os.PowerManager
-import android.provider.MediaStore
import android.provider.Settings
-import android.webkit.MimeTypeMap
import androidx.core.app.NotificationManagerCompat
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
@@ -28,6 +25,7 @@ import java.util.concurrent.Executors
class MainActivity : FlutterActivity() {
private val io = Executors.newSingleThreadExecutor()
private var pendingNotification: MethodChannel.Result? = null
+ private var pendingSave: Pair<List<String>, MethodChannel.Result>? = null
override 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()) return
val 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) return
pendingNotification?.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.xml
index 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.xml
index 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.xml
index 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.xml
index 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.xml
index 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.kt
new file mode 100644
index 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")
+}