NativeScript file.renameSync()在Android 12上执行失败求助

问题根源分析 #

Android 12（API 31）对文件系统的资源管理和权限模型做了调整，导致NativeScript旧版@nativescript/core的文件重命名方法出现兼容性问题，常见原因包括：

• 同步删除文件后，系统未及时释放文件资源锁，立即执行重命名时触发冲突
• NativeScript的renameSync/rename方法封装未适配Android 12的文件操作逻辑

可行解决办法 #

1. 改用异步删除+异步重命名，确保资源释放 #

同步删除的回调仅用于错误捕获，无法保证文件资源已完全释放，改用异步等待删除完成后再执行重命名：

const fs = require("@nativescript/core/file-system");    

let documentsPath = fs.knownFolders.documents().path; 
let filePath = fs.path.join(documentsPath, filename);
let tempPath = fs.path.join(documentsPath, filename + ".tmp");

let newFile = await http.getFile(httpRequestOptions, tempPath);

if (fs.File.exists(filePath)) {
  let oldFile = fs.File.fromPath(filePath); 
  try {
    // 异步等待文件删除完成
    await oldFile.remove();
  } catch (error) {
    console.log("removeError: " + error );
  }
}

try {
  // 用异步rename替代同步方法，避免阻塞导致的资源冲突
  await newFile.rename(filename);
} catch (error) {
  console.log("renameError: " + error );
}

2. 直接调用Android原生文件API绕过封装 #

如果NativeScript的fs封装存在兼容性问题，直接使用Android原生java.io.File类执行重命名：

const fs = require("@nativescript/core/file-system");    

let documentsPath = fs.knownFolders.documents().path; 
let filePath = fs.path.join(documentsPath, filename);
let tempPath = fs.path.join(documentsPath, filename + ".tmp");

let newFile = await http.getFile(httpRequestOptions, tempPath);

// 用Android原生API操作文件
const tempAndroidFile = new java.io.File(tempPath);
const targetAndroidFile = new java.io.File(filePath);

// 确保目标文件已被彻底删除
if (targetAndroidFile.exists()) {
  targetAndroidFile.delete();
}

// 执行原生重命名
const renameSuccess = tempAndroidFile.renameTo(targetAndroidFile);
if (!renameSuccess) {
  console.log("原生重命名失败");
}

3. 升级@nativescript/core到最新稳定版 #

旧版本的NativeScript核心库可能未适配Android 12的文件系统变化，执行升级命令：

npm install @nativescript/core@latest --save

升级后重新编译项目，验证重命名功能是否恢复正常。

4. 确认应用存储权限配置 #

虽然你当前能正常创建/删除文件，但仍需确保AndroidManifest.xml的权限配置正确：

• 针对Android 12及以上，无需WRITE_EXTERNAL_STORAGE权限（操作应用私有目录）
• 若需兼容旧版本，保留以下权限声明：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="30" />

内容的提问来源于stack exchange，提问作者David