Add SyncState documentation and update links

google-labs-jules[bot] · 0xLeif · commit 90cc1b1affef · 2025-08-19T23:05:26.000-06:00
diff --git a/documentation/de/starting-to-use-syncstate.md b/documentation/de/starting-to-use-syncstate.md
@@ -0,0 +1,22 @@
+Um SyncState zu nutzen, müssen Sie zuerst die iCloud-Fähigkeiten und -Berechtigungen in Ihrem Xcode-Projekt einrichten. Hier ist eine Einführung, die Sie durch den Prozess führt:
+
+### Einrichten der iCloud-Fähigkeiten:
+
+1. Öffnen Sie Ihr Xcode-Projekt und passen Sie die Bundle-Identifikatoren für die macOS- und iOS-Ziele an Ihre eigenen an.
+2. Als Nächstes müssen Sie die iCloud-Fähigkeit zu Ihrem Projekt hinzufügen. Wählen Sie dazu Ihr Projekt im Projektnavigator aus und wählen Sie dann Ihr Ziel aus. Klicken Sie in der Tableiste oben im Editorbereich auf "Capabilities".
+3. Aktivieren Sie im Bereich "Capabilities" iCloud, indem Sie auf den Schalter in der iCloud-Zeile klicken. Sie sollten sehen, wie sich der Schalter in die Ein-Position bewegt.
+4. Sobald Sie iCloud aktiviert haben, müssen Sie den Schlüssel-Wert-Speicher aktivieren. Dies können Sie tun, indem Sie das Kontrollkästchen "Key-Value storage" aktivieren.
+
+### Aktualisieren der Berechtigungen:
+
+1. Sie müssen nun Ihre Berechtigungsdatei aktualisieren. Öffnen Sie die Berechtigungsdatei für Ihr Ziel.
+2. Stellen Sie sicher, dass der Wert des iCloud-Schlüssel-Wert-Speichers mit Ihrer eindeutigen Schlüssel-Wert-Speicher-ID übereinstimmt. Ihre eindeutige ID sollte dem Format `$(TeamIdentifierPrefix)<Ihre Schlüssel-Wert-Speicher-ID>` folgen. Der Standardwert sollte etwa `$(TeamIdentifierPrefix)$(CFBundleIdentifier)` lauten. Dies ist für Einzelplattform-Apps in Ordnung, aber wenn Ihre App auf mehreren Apple-Betriebssystemen läuft, ist es wichtig, dass die Teile der Schlüssel-Wert-Speicher-ID für beide Ziele gleich sind.
+
+### Konfigurieren der Geräte:
+
+Zusätzlich zur Konfiguration des Projekts selbst müssen Sie auch die Geräte vorbereiten, auf denen das Projekt ausgeführt wird.
+
+- Stellen Sie sicher, dass iCloud Drive sowohl auf iOS- als auch auf macOS-Geräten aktiviert ist.
+- Melden Sie sich auf beiden Geräten mit demselben iCloud-Konto an.
+
+Wenn Sie Fragen haben oder auf Probleme stoßen, können Sie sich gerne an uns wenden oder ein Problem melden.
diff --git a/documentation/de/usage-syncstate.md b/documentation/de/usage-syncstate.md
@@ -122,7 +122,7 @@ struct SyncStateExampleApp: App {
 
 ### Aktivieren des iCloud-Schlüssel-Wert-Speichers
 
-Um die iCloud-Synchronisierung zu aktivieren, stellen Sie sicher, dass Sie dieser Anleitung folgen, um die Funktion des iCloud-Schlüssel-Wert-Speichers zu aktivieren: [Erste Schritte mit SyncState](https://github.com/0xLeif/AppState/wiki/Starting-to-use-SyncState).
+Um die iCloud-Synchronisierung zu aktivieren, stellen Sie sicher, dass Sie dieser Anleitung folgen, um die Funktion des iCloud-Schlüssel-Wert-Speichers zu aktivieren: [Erste Schritte mit SyncState](starting-to-use-syncstate.md).
 
 ### SyncState: Hinweise zum iCloud-Speicher
 
diff --git a/documentation/en/starting-to-use-syncstate.md b/documentation/en/starting-to-use-syncstate.md
@@ -0,0 +1,22 @@
+To utilize SyncState, you will first need to set up iCloud capabilities and entitlements in your Xcode project. Here's an introduction to guide you through the process:
+
+### Setting Up iCloud Capabilities:
+
+1. Open your Xcode project and adjust the Bundle Identifiers for both macOS and iOS targets to match your own.
+2. Next, you need to add the iCloud capability to your project. To do this, select your project in the Project Navigator, then select your target. In the tab bar at the top of the editor area, click on "Capabilities".
+3. In the Capabilities pane, turn on iCloud by clicking the switch in the iCloud row. You should see the switch move to the On position.
+4. Once you have enabled iCloud, you need to enable Key-Value storage. You can do this by checking the "Key-Value storage" checkbox.
+
+### Updating the Entitlements:
+
+1. You will now need to update your entitlements file. Open the entitlements file for your target.
+2. Make sure the iCloud Key-Value Store value matches your unique key-value store ID. Your unique ID should follow the format `$(TeamIdentifierPrefix)<your key-value_store ID>`. The default value should be something like, `$(TeamIdentifierPrefix)$(CFBundleIdentifier)`. This is fine for single platform apps, but if your app is on multiple Apple OSs, it’s important that the key-value store ID portions are the same for both targets.
+
+### Configuring the Devices:
+
+In addition to configuring the project itself, you also need to prepare the devices that will run the project.
+
+- Ensure that iCloud Drive is enabled on both iOS and macOS devices.
+- Log into both devices using the same iCloud account.
+
+If you have any questions or run into any issues, feel free to reach out or submit an issue.
diff --git a/documentation/en/usage-syncstate.md b/documentation/en/usage-syncstate.md
@@ -122,7 +122,7 @@ struct SyncStateExampleApp: App {
 
 ### Enabling iCloud Key-Value Store
 
-To enable iCloud syncing, make sure you follow this guide to enable the iCloud Key-Value Store capability: [Starting to use SyncState](https://github.com/0xLeif/AppState/wiki/Starting-to-use-SyncState).
+To enable iCloud syncing, make sure you follow this guide to enable the iCloud Key-Value Store capability: [Starting to use SyncState](starting-to-use-syncstate.md).
 
 ### SyncState: Notes on iCloud Storage
 
diff --git a/documentation/es/starting-to-use-syncstate.md b/documentation/es/starting-to-use-syncstate.md
@@ -0,0 +1,22 @@
+Para utilizar SyncState, primero deberá configurar las capacidades y los derechos de iCloud en su proyecto de Xcode. Aquí hay una introducción para guiarlo a través del proceso:
+
+### Configuración de las capacidades de iCloud:
+
+1. Abra su proyecto de Xcode y ajuste los identificadores de paquete para los destinos de macOS e iOS para que coincidan con los suyos.
+2. A continuación, debe agregar la capacidad de iCloud a su proyecto. Para hacer esto, seleccione su proyecto en el Navegador de proyectos, luego seleccione su destino. En la barra de pestañas en la parte superior del área del editor, haga clic en "Capabilities".
+3. En el panel Capacidades, active iCloud haciendo clic en el interruptor de la fila de iCloud. Debería ver que el interruptor se mueve a la posición de encendido.
+4. Una vez que haya habilitado iCloud, debe habilitar el almacenamiento de clave-valor. Puede hacerlo marcando la casilla de verificación "Key-Value storage".
+
+### Actualización de los derechos:
+
+1. Ahora deberá actualizar su archivo de derechos. Abra el archivo de derechos para su destino.
+2. Asegúrese de que el valor del Almacén de clave-valor de iCloud coincida con su ID de almacén de clave-valor único. Su ID único debe seguir el formato `$(TeamIdentifierPrefix)<su_ID_de_almacén_de_clave-valor>`. El valor predeterminado debería ser algo así como `$(TeamIdentifierPrefix)$(CFBundleIdentifier)`. Esto está bien para aplicaciones de una sola plataforma, pero if su aplicación está en varios sistemas operativos de Apple, es importante que las partes de la ID del almacén de clave-valor sean las mismas para ambos destinos.
+
+### Configuración de los dispositivos:
+
+Además de configurar el proyecto en sí, también debe preparar los dispositivos que ejecutarán el proyecto.
+
+- Asegúrese de que iCloud Drive esté habilitado en los dispositivos iOS y macOS.
+- Inicie sesión en ambos dispositivos con la misma cuenta de iCloud.
+
+Si tiene alguna pregunta o tiene algún problema, no dude en comunicarse o enviar un problema.
diff --git a/documentation/es/usage-syncstate.md b/documentation/es/usage-syncstate.md
@@ -122,7 +122,7 @@ struct SyncStateExampleApp: App {
 
 ### Habilitar el Almacenamiento de Clave-Valor de iCloud
 
-Para habilitar la sincronización de iCloud, asegúrese de seguir esta guía para habilitar la capacidad de Almacenamiento de Clave-Valor de iCloud: [Comenzando a usar SyncState](https://github.com/0xLeif/AppState/wiki/Starting-to-use-SyncState).
+Para habilitar la sincronización de iCloud, asegúrese de seguir esta guía para habilitar la capacidad de almacenamiento de clave-valor de iCloud: [Comenzando a usar SyncState](starting-to-use-syncstate.md).
 
 ### SyncState: Notas sobre el Almacenamiento de iCloud
 
diff --git a/documentation/fr/starting-to-use-syncstate.md b/documentation/fr/starting-to-use-syncstate.md
@@ -0,0 +1,22 @@
+Pour utiliser SyncState, vous devrez d'abord configurer les fonctionnalités et les autorisations iCloud dans votre projet Xcode. Voici une introduction pour vous guider tout au long du processus :
+
+### Configuration des fonctionnalités iCloud :
+
+1. Ouvrez votre projet Xcode et ajustez les identifiants de lot pour les cibles macOS et iOS afin qu'ils correspondent aux vôtres.
+2. Ensuite, vous devez ajouter la fonctionnalité iCloud à votre projet. Pour ce faire, sélectionnez votre projet dans le navigateur de projets, puis sélectionnez votre cible. Dans la barre d'onglets en haut de la zone de l'éditeur, cliquez sur « Capacités ».
+3. Dans le volet Capacités, activez iCloud en cliquant sur le commutateur de la ligne iCloud. Vous devriez voir le commutateur passer en position Activé.
+4. Une fois que vous avez activé iCloud, vous devez activer le stockage clé-valeur. Vous pouvez le faire en cochant la case « Stockage clé-valeur ».
+
+### Mise à jour des autorisations :
+
+1. Vous devrez maintenant mettre à jour votre fichier d'autorisations. Ouvrez le fichier d'autorisations de votre cible.
+2. Assurez-vous que la valeur du magasin clé-valeur iCloud correspond à votre ID de magasin clé-valeur unique. Votre ID unique doit respecter le format `$(TeamIdentifierPrefix)<votre_ID_de_magasin_clé-valeur>`. La valeur par défaut doit être quelque chose comme `$(TeamIdentifierPrefix)$(CFBundleIdentifier)`. C'est très bien pour les applications à plate-forme unique, mais si votre application se trouve sur plusieurs systèmes d'exploitation Apple, il est important que les parties de l'ID du magasin clé-valeur soient les mêmes pour les deux cibles.
+
+### Configuration des appareils :
+
+En plus de configurer le projet lui-même, vous devez également préparer les appareils qui exécuteront le projet.
+
+- Assurez-vous qu'iCloud Drive est activé sur les appareils iOS и macOS.
+- Connectez-vous aux deux appareils avec le même compte iCloud.
+
+Si vous avez des questions ou rencontrez des problèmes, n'hésitez pas à nous contacter ou à soumettre un problème.
diff --git a/documentation/fr/usage-syncstate.md b/documentation/fr/usage-syncstate.md
@@ -122,7 +122,7 @@ struct SyncStateExampleApp: App {
 
 ### Activer le Magasin Clé-Valeur iCloud
 
-Pour activer la synchronisation iCloud, assurez-vous de suivre ce guide pour activer la capacité de Magasin Clé-Valeur iCloud : [Commencer à utiliser SyncState](https://github.com/0xLeif/AppState/wiki/Starting-to-use-SyncState).
+Pour activer la synchronisation iCloud, assurez-vous de suivre ce guide pour activer la fonctionnalité de stockage clé-valeur iCloud : [Démarrer avec SyncState](starting-to-use-syncstate.md).
 
 ### SyncState : Notes sur le Stockage iCloud
 
diff --git a/documentation/hi/starting-to-use-syncstate.md b/documentation/hi/starting-to-use-syncstate.md
@@ -0,0 +1,22 @@
+SyncState का उपयोग करने के लिए, आपको सबसे पहले अपने Xcode प्रोजेक्ट में iCloud क्षमताओं और अधिकारों को सेट करना होगा। प्रक्रिया में आपका मार्गदर्शन करने के लिए यहाँ एक परिचय दिया गया है:
+
+### iCloud क्षमताओं को सेट करना:
+
+1. अपना Xcode प्रोजेक्ट खोलें और macOS और iOS दोनों लक्ष्यों के लिए बंडल पहचानकर्ताओं को अपने से मेल खाने के लिए समायोजित करें।
+2. इसके बाद, आपको अपने प्रोजेक्ट में iCloud क्षमता को जोड़ना होगा। ऐसा करने के लिए, प्रोजेक्ट नेविगेटर में अपने प्रोजेक्ट का चयन करें, फिर अपने लक्ष्य का चयन करें। संपादक क्षेत्र के शीर्ष पर टैब बार में, "Capabilities" पर क्लिक करें।
+3. क्षमताएँ फलक में, iCloud पंक्ति में स्विच पर क्लिक करके iCloud चालू करें। आपको स्विच को चालू स्थिति में ले जाते हुए देखना चाहिए।
+4. एक बार जब आप iCloud सक्षम कर लेते हैं, तो आपको कुंजी-मूल्य संग्रहण सक्षम करने की आवश्यकता होती है। आप "Key-Value storage" चेकबॉक्स को चेक करके ऐसा कर सकते हैं।
+
+### अधिकारों को अद्यतन करना:
+
+1. अब आपको अपनी अधिकार फ़ाइल को अद्यतन करने की आवश्यकता होगी। अपने लक्ष्य के लिए अधिकार फ़ाइल खोलें।
+2. सुनिश्चित करें कि iCloud कुंजी-मूल्य स्टोर मान आपकी अद्वितीय कुंजी-मूल्य स्टोर ID से मेल खाता है। आपकी अद्वितीय ID को `$(TeamIdentifierPrefix)<आपकी कुंजी-मूल्य_स्टोर ID>` प्रारूप का पालन करना चाहिए। डिफ़ॉल्ट मान कुछ इस तरह होना चाहिए, `$(TeamIdentifierPrefix)$(CFBundleIdentifier)`। यह एकल प्लेटफ़ॉर्म ऐप्स के लिए ठीक है, लेकिन यदि आपका ऐप कई Apple OS पर है, तो यह महत्वपूर्ण है कि कुंजी-मूल्य स्टोर ID के भाग दोनों लक्ष्यों के लिए समान हों।
+
+### उपकरणों को कॉन्फ़िगर करना:
+
+प्रोजेक्ट को कॉन्फ़िगर करने के अलावा, आपको उन उपकरणों को भी तैयार करने की आवश्यकता है जो प्रोजेक्ट को चलाएंगे।
+
+- सुनिश्चित करें कि iCloud ड्राइव iOS और macOS दोनों उपकरणों पर सक्षम है।
+- एक ही iCloud खाते का उपयोग करके दोनों उपकरणों में लॉग इन करें।
+
+यदि आपके कोई प्रश्न हैं या कोई समस्या आती है, तो बेझिझक संपर्क करें या कोई समस्या सबमिट करें।
diff --git a/documentation/hi/usage-syncstate.md b/documentation/hi/usage-syncstate.md
@@ -122,7 +122,7 @@ struct SyncStateExampleApp: App {
 
 ### iCloud की-वैल्यू स्टोर सक्षम करना
 
-iCloud सिंक्रनाइज़ेशन को सक्षम करने के लिए, सुनिश्चित करें कि आप iCloud की-वैल्यू स्टोर क्षमता को सक्षम करने के लिए इस गाइड का पालन करते हैं: [SyncState का उपयोग शुरू करना](https://github.com/0xLeif/AppState/wiki/Starting-to-use-SyncState)।
+iCloud सिंकिंग सक्षम करने के लिए, सुनिश्चित करें कि आप iCloud कुंजी-मूल्य संग्रहण क्षमता को सक्षम करने के लिए इस गाइड का पालन करते हैं: [SyncState का उपयोग शुरू करना](starting-to-use-syncstate.md).
 
 ### SyncState: iCloud संग्रहण पर नोट्स
 
diff --git a/documentation/pt/starting-to-use-syncstate.md b/documentation/pt/starting-to-use-syncstate.md
@@ -0,0 +1,22 @@
+Para utilizar o SyncState, você primeiro precisará configurar os recursos e direitos do iCloud em seu projeto do Xcode. Aqui está uma introdução para guiá-lo através do processo:
+
+### Configurando os recursos do iCloud:
+
+1. Abra seu projeto do Xcode e ajuste os identificadores de pacote para os destinos macOS e iOS para corresponderem aos seus.
+2. Em seguida, você precisa adicionar o recurso iCloud ao seu projeto. Para fazer isso, selecione seu projeto no Navegador de projetos e, em seguida, selecione seu destino. Na barra de guias na parte superior da área do editor, clique em "Recursos".
+3. No painel Recursos, ative o iCloud clicando no botão na linha do iCloud. Você deve ver o botão mudar para a posição Ligado.
+4. Depois de habilitar o iCloud, você precisa habilitar o armazenamento de valor-chave. Você pode fazer isso marcando a caixa de seleção "Armazenamento de valor-chave".
+
+### Atualizando os direitos:
+
+1. Agora você precisará atualizar seu arquivo de direitos. Abra o arquivo de direitos para o seu destino.
+2. Certifique-se de que o valor do Repositório de Valor-Chave do iCloud corresponda ao seu ID de repositório de valor-chave exclusivo. Seu ID exclusivo deve seguir o formato `$(TeamIdentifierPrefix)<seu_ID_de_repositório_de_valor-chave>`. O valor padrão deve ser algo como, `$(TeamIdentifierPrefix)$(CFBundleIdentifier)`. Isso é bom para aplicativos de plataforma única, mas se seu aplicativo estiver em vários sistemas operacionais da Apple, é importante que as partes do ID do repositório de valor-chave sejam as mesmas para ambos os destinos.
+
+### Configurando os dispositivos:
+
+Além de configurar o projeto em si, você também precisa preparar os dispositivos que executarão o projeto.
+
+- Certifique-se de que o iCloud Drive esteja habilitado nos dispositivos iOS e macOS.
+- Faça login em ambos os dispositivos usando a mesma conta do iCloud.
+
+Se você tiver alguma dúvida ou encontrar algum problema, sinta-se à vontade para entrar em contato ou enviar um problema.
diff --git a/documentation/pt/usage-syncstate.md b/documentation/pt/usage-syncstate.md
@@ -122,7 +122,7 @@ struct SyncStateExampleApp: App {
 
 ### Habilitando o Armazenamento de Chave-Valor do iCloud
 
-Para habilitar a sincronização do iCloud, certifique-se de seguir este guia para habilitar a capacidade de Armazenamento de Chave-Valor do iCloud: [Começando a usar o SyncState](https://github.com/0xLeif/AppState/wiki/Starting-to-use-SyncState).
+Para habilitar a sincronização do iCloud, certifique-se de seguir este guia para habilitar a capacidade de Armazenamento de Chave-Valor do iCloud: [Começando a usar o SyncState](starting-to-use-syncstate.md).
 
 ### SyncState: Notas sobre o Armazenamento do iCloud
 
diff --git a/documentation/ru/starting-to-use-syncstate.md b/documentation/ru/starting-to-use-syncstate.md
diff --git a/documentation/ru/usage-syncstate.md b/documentation/ru/usage-syncstate.md
diff --git a/documentation/zh-CN/starting-to-use-syncstate.md b/documentation/zh-CN/starting-to-use-syncstate.md
diff --git a/documentation/zh-CN/usage-syncstate.md b/documentation/zh-CN/usage-syncstate.md
