Better iCloud sync integration

[ACTCD]

Currently, we tell users in the README:

Tip: for optimal cross platform experience it's a good idea to use an iCloud folder for syncing between macOS and iOS

But the current iCloud sync has some doubts for users:

• We don't really support iCloud in the app, so it won't appear in the list of Apps using iCloud.
• Not out of the box, users need to manually set and select the same path in iCloud Drive in different devices.
• The folder is not indicated as belonging to the App in iCloud (there is a folder icon containing the App Icon)
• Syncing process of script files is delayed, uncertain and uncontrolled
• For devices with limited space, local files may be evictioned due to iCloud optimization
  • Could be resolved by the Keep Downloaded feature introduced in macOS 15 / iOS 18
• May be briefly inaccessible due to synching, downloading, etc.; remove bookmark and restore default path

We may need to officially support iCloud features, and the synchronization mechanism and process will be managed by the App.

References:
https://developer.apple.com/library/archive/documentation/DataManagement/Conceptual/CloudKitQuickStart/Introduction/Introduction.html
https://developer.apple.com/documentation/cloudkit/
https://developer.apple.com/documentation/technotes/tn3162-understanding-cloudkit-throttles

[biuuu]

Will the data saved with GM.setValue also be synced to iCloud?

[ACTCD]

@biuuu No, not at the moment.

[keycommander]

Send me the link so the .js i can copy over into a scriptable application or web extension.

[ACTCD]

@keycommander Sorry, I don't understand what you are talking about. Can you explain it in more detail?

[keycommander]

@keycommander Sorry, I don't understand what you are talking about. Can you explain it in more detail?

Im just wondering how I use this repository

[ACTCD]

@keycommander I don't understand what you are talking about, if your question is not related to this issue I will delete your comments.

Regarding this project, you should read the README, and any other questions you should ask and elaborate in Discussions.

To learn how to use GitHub, please refer to the community documentations.

[dblsaiko]

For devices with limited space, local files may be evictioned due to iCloud optimization

I just hit this and was confused as to why my scripts suddenly weren't working anymore. Seems like Userscripts doesn't pick up the files when they get evicted until manually downloaded again through Finder. Is this known?

[ACTCD]

@2xsaiko As I wrote. Since the extension does not currently use the iCloud related APIs, we won't know when the system decides to evict a file, and we won't be able to read it again. Thanks for your feedback.

[dblsaiko]

Sure, but usually, files will download on access, and non-downloaded files are visible in directories. You can see this by opening iCloud Drive in your terminal and e.g. running ls, cat or cp on a couple files. Everything is there, just accessing it might block a few seconds while it downloads, and these commands don't use the iCloud API either. Userscripts doesn't even pick the files up however.