native.setSync()

类型 函数
库 native.*
返回值 布尔值 和 字符串
修订版本 版本 2024.3703
关键词 同步, iCloud, 备份, 文档
另请参阅 native.getSync()

概述

设置 macOS 和 iOS 系统上 `system.DocumentsDirectory` 和 `system.ApplicationSupportDirectory` 中文件的 iCloud 自动备份标志。

iCloud 备份默认为 `true`，必须使用此 API 将其设置为 `false` 才能禁用文件的自动 iCloud 备份。

此函数最多返回两个值

注意事项

此函数仅适用于 macOS 和 iOS 平台。

语法

native.setSync( filename, params )
filename (必填)

字符串. 文件名（包括路径）。

params (必填)

表. 设置为 `{ iCloudBackup = flag }`，其中 `flag` 为 `true` 表示启用 iCloud 备份（默认），`false` 表示禁用它。

示例

-- Disable file backup
-- Assumes that a file named 'SavedData.txt' is in 'system.DocumentsDirectory'

local results, errStr = native.setSync( "SavedData.txt", { iCloudBackup = false } ) 
-- Disable file backup in a subdirectory within the Documents directory
-- Assumes that a file named 'SavedData.txt' is in a 'data' subdirectory of 'system.DocumentsDirectory'

local results, errStr = native.setSync( "data/SavedData.txt", { iCloudBackup = false } )