Het CloudKit Dashboard is een onmisbare web-gebaseerde interface voor iOS-ontwikkelaars die de gegevens die ze in iCloud opslaan moeten beheren, monitoren en manipuleren. Terwijl het CloudKit-kader zelf het zware tillen van gegevens over apparaten behandelt, geeft het dashboard u een transparant venster in die gegevens, zodat u administratieve taken kunt uitvoeren, problemen kunt debuggen, schema's kunt testen en ervoor kunt zorgen dat uw apps een goede opslagarchitectuur hebben. Of u nu een eenvoudige notes-app of een complex multi-user platform bouwt, het beheersen van het CloudKit Dashboard zal u helpen sneller te verzenden en de gegevensintegriteit op lange termijn te behouden.

Wat is het CloudKit Dashboard?

Het CloudKit Dashboard is een webtool die Apple u direct laat communiceren met uw apps CloudKit containers. Het vervangt de noodzaak om rauwe API oproepen te schrijven voor gemeenschappelijke data operaties, het aanbieden van een grafische interface voor het bekijken van records, het aanpassen van machtigingen, en het beheren van het schema. Ontwikkelaars met een Apple Developer account kan toegang krijgen vanaf elke moderne browser. Het dashboard is vooral waardevol tijdens de ontwikkeling en testen, waar snelle iteraties op datamodellen of on-the-fly fixes kunnen besparen uren van code-debug cycli.

Naast basis CRUD-bewerkingen (creëren, lezen, bijwerken, verwijderen) ondersteunt het dashboard ook meer geavanceerde taken zoals het instellen van abonnementen voor pushmeldingen, het beheren van gebruikersrollen en machtigingen, en het exporteren of importeren van hele datasets. Voor teams biedt het een gedeelde omgeving waar backend-configuraties kunnen worden herzien en aangepast zonder dat een lokale bouw vereist is.

Apple . Documentation biedt een solide basis, maar in de praktijk veel ontwikkelaars kijken uit over de volledige kracht van het dashboard. Deze gids zal u door elke belangrijke functie en bieden bruikbare advies voor het effectief gebruiken van het in uw iOS app workflow.

Toegang tot het CloudKit Dashboard instellen

Voordat u uw apps iCloud-gegevens kunt beheren via het dashboard, moet u een actief Apple Developer-account hebben dat is ingeschreven in het Apple Developer Program. CloudKit-toegang is opgenomen met alle account-opties, maar u moet de CloudKit-functie in uw Xcode-project inschakelen en ervoor zorgen dat uw apps-bundel-identiteit correct is geregistreerd.

Om het dashboard te bereiken, navigeer naar https://icloud.developer.apple.com en meld je aan met je Apple ID. Eenmaal geauthenticeerd, zie je een lijst van je apps CloudKit containers. Selecteer de juiste container voor de app die je wilt beheren. Als je meerdere omgevingen hebt (ontwikkeling, productie, enscenering), kun je tussen hen schakelen met behulp van de omgevingsselector aan de bovenkant van het dashboard.

Merk op dat het dashboard dezelfde rolgebaseerde toegangscontrole respecteert die u in CloudKit configureert. Als u als team werkt, kan elk lid verschillende rechten hebben, van alleen-lezen tot volledige administratieve rechten. Zorg ervoor dat uw Apple ID de juiste rol heeft voor de container die u moet beheren.

Begrip containers en omgevingen

Elke iOS-app die CloudKit gebruikt, krijgt een standaard container toegewezen (geïdentificeerd door uw bundel-ID plus .icloud

De CloudKit Dashboard Interface navigeren

Eenmaal in een container, presenteert het dashboard verschillende tabbladen: [Data, Telemetrie, Logs, API Access, Subscripties en Instellingen[]]. Het tabblad Gegevens is waar het meeste dagelijkse beheer plaatsvindt. Hier ziet u een lijst van recordtypes en zones. Het begrijpen van de indeling van dit tabblad zal u snel helpen verplaatsen.

De linker zijbalk geeft alle recordtypes die in uw schema zijn gedefinieerd. Door op een recordtype te klikken, wordt een tabel weergegeven met de records, met kolommen voor elk veld. U kunt grote datasets sorteren, filteren en pagineren. Elk record heeft een unieke record-ID (recordName) die constant blijft in alle omgevingen. Bovenaan het tabblad Gegevens vindt u een zone switcher. Zones zijn logische groepen van records; de standaard zone heet \ defaultZone, maar u kunt aangepaste zones voor een betere organisatie maken.

Recordtypebeheer

Record types definiëren de structuur van uw gegevens . . vergelijkbaar met een tabel in een relationele database. In het dashboard kunt u nieuwe record types aanmaken, velden toevoegen of verwijderen, veldtypen wijzigen (String, Number, Date, Asset, Reference, etc.) en standaard waarden instellen. Het dashboard biedt hiervoor een op formulieren gebaseerde editor, die veel intuïtiever is dan het schrijven van JSON. Wanneer u een record type in de Ontwikkeling omgeving opslaat, wordt het onmiddellijk beschikbaar voor uw app in die omgeving. Wees ervan bewust dat record types in Productie niet kan worden verwijderd of hun velden kunnen worden verwijderd zodra ze zijn aangemaakt; u kunt alleen nieuwe velden toevoegen. Dit is een kritieke veiligheidsmaatregel om gegevensverlies te voorkomen.

Beste praktijk: Gebruik de Ontwikkelingsomgeving om te experimenteren met recordtypes voordat ze worden geïmplementeerd. De dashboard-schema-editor bevat validatie dat incompatibele wijzigingen worden gemarkeerd (bijvoorbeeld het veranderen van een veld van Number naar Asset). Maak altijd een back-up van uw schema door het te exporteren als een JSON-bestand (beschikbaar onder het tabblad Instellingen) voordat u grote wijzigingen maakt.

Gegevensarchief beheren

Het bekijken en bewerken van individuele records is de meest voorkomende dagelijkse taak in het dashboard. Wanneer u een recordtype opent, vertegenwoordigt elke rij één record. Door op een rij te klikken worden alle veldwaarden, inclusief activa en referenties, weergegeven. U kunt velden inline bewerken of de volledige editor gebruiken voor complexe velden zoals Locatie of referentielijsten.

Het bewerken van records direct in het dashboard is een krachtig debuggen gereedschap.[ Bijvoorbeeld, als uw app toont onjuiste gegevens als gevolg van een vorige bug, kunt u de record handmatig corrigeren en controleren of de app pick-up van de verandering. Echter, uiterst voorzichtig: wijzigingen in het dashboard omzeilen elke zakelijke logica of validatie die u in uw app. Altijd dubbel-controleren dat de gegevens die u in te voeren overeenkomt met uw schema verwachtingen en niet schendt enige beperkingen (zoals vereiste velden of unieke toetsen).

U kunt ook bestanden afzonderlijk of in bulk verwijderen. Bulk verwijdering is beschikbaar na het selecteren van meerdere records via checkboxes. Verwijdering is permanent . . CloudKit heeft geen prullenbak. Daarom is het verstandig om records te exporteren voordat u ze verwijdert, vooral als u ze later nodig hebt voor het testen of audit trails.

Filteren en zoeken records

Het dashboard bevat een filterbouwer waarmee u voorwaarden kunt specificeren op een geïndexeerd veld. U kunt bijvoorbeeld alleen filteren om te laten zien waar een Booleaans veld is of waar een Date veld binnen een bepaald bereik valt. U kunt meerdere filters combineren met AND/OR logica. Dit is van onschatbare waarde wanneer u een specifiek stukje gegevens moet vinden tussen duizenden records. De filters werken op de server kant, dus zelfs grote containers reageren snel. Echter, filteren op niet-geïndexeerde velden wordt niet ondersteund . . U moet ervoor zorgen dat de velden waarop u filtert worden geïndexeerd in uw schema (die CloudKit indexeert automatisch voor de meeste veldtypes behalve Asset en Bytes).

Werken met Zones en Veiligheid

CloudKit zones kunt u uw container partitie gegevens voor fijnere korrelige controle over toegang en synchronisatie. Het dashboard maakt zonebeheer eenvoudig. U kunt aangepaste zones maken, hernoemen, en verwijderen (zone verwijderen verwijdert alle records binnen de zone). Elke zone kan zijn eigen set van machtigingen, gescheiden van de record-level permissies.

Beveiliging is een kritische overweging bij het beheer van zones. In CloudKit, elke record kan specifieke machtigingen (wereldleesbaar, alleen maker, enz.). Echter, zones kunt u standaardmachtigingen die van toepassing zijn op alle records in hen . . tenzij overridden. Voor toepassingen die moeten openbare versus private gegevens scheiden, het gebruik van aangepaste zones is een schoon architectonisch patroon. Bijvoorbeeld, je zou een ..PublicZone ..met wereldleesbare records en een .PrivateZone . . waar alleen de record maker kan lezen. Het dashboard kunt u deze toestemmingsinstellingen direct op de zone bewerken.

Zones creëren en verwijderen

Om een zone te creëren, ga naar de Zones sectie van het tabblad Gegevens, klik op

In- en uitvoerstrategieën voor gegevens

Een van de meest waardevolle functies van het CloudKit Dashboard is de mogelijkheid om gegevens te importeren en exporteren in JSON-formaat. Exporteren stelt u in staat om een back-up van uw gehele container (of geselecteerde recordtypes/zones) als JSON-bestand. Importeren kunt u een nieuwe database starten of een back-up te herstellen. Beide operaties zijn essentieel voor het testen, ensceneren en herstellen van rampen.

Gegevens exporteren

Om te exporteren, ga naar het tabblad Gegevens en selecteer de record types of zones die u wilt opnemen. Klik op de knop .Inclusief .Het dashboard zal een JSON bestand met alle records en hun huidige waarden. Export kan groot zijn . Export kan voor containers met tienduizenden records, het proces kan een paar minuten duren. U kunt de hele container of een deelverzameling met filters exporteren. Merk op dat het exportbestand bevat de schema definitie als u kiest voor de optie .Include Schema . Dit is handig voor het reproduceren van dezelfde structuur in een andere omgeving.

Beste praktijk: Plan regelmatige export voor uw Productie container. Terwijl CloudKit is zeer betrouwbaar, met een offline back-up geeft u gemoedsrust en kunt u herstellen naar een specifiek punt in de tijd als een gegevens corruptie bug wordt ontdekt. Bewaar de JSON-bestanden op een veilige locatie met versiecontrole.

Gegevens importeren

Importeren is even eenvoudig. Navigeer naar het tabblad Gegevens, klik op

Importeert de prestaties varieert. Voor zeer grote datasets (meer dan 100.000 records), overwegen het bestand te splitsen in meerdere kleinere brokken en sequentiële importeren om browser time-outs te vermijden. Het dashboard zal een voortgangsindicator tonen; sluit het tabblad browser niet terwijl een import wordt uitgevoerd.

Monitoring en debuggen met het Dashboard

Naast datamanagement biedt het CloudKit Dashboard monitoring- en debugtools waarmee u de knelpunten, foutenpercentages en ongewone verkeerspatronen kunt identificeren.

Telemetrie en logboeken

Het Telemetrie tabblad geeft realtime grafieken met aantal verzoeken, latentie en foutenpercentages voor uw CloudKit-operaties. U kunt filteren op operatietype (query, fetch, modific, etc.) en op tijdbereik. Dit is uiterst handig wanneer u vermoedt dat uw app buitensporige verzoeken of slagsnelheidslimieten genereert. Het dashboard toont ook een uitsplitsing van fouten door foutcode, die u kan sturen naar specifieke problemen zoals . outreaching falen of .

Het tabblad Logs toont een chronologische lijst van recente CloudKit-verzoeken die door uw app zijn gedaan, inclusief de gebruikers-ID (indien aangemeld), de bewerking en eventuele fouten. U kunt individuele log-items inspecteren om de exacte parameters en respons te zien. Dit niveau van transparantie is een spel-wisselaar voor het debuggen .U kunt bevestigen of uw app de juiste queries stuurt en de verwachte resultaten ontvangt.

Beheer van abonnementen

Met CloudKit-abonnementen kunt u pushmeldingen ontvangen wanneer de gegevens veranderen. Het dashboard laat u toe om abonnementen direct aan te maken, te bekijken en te verwijderen. Dit kan sneller zijn dan via de app te testen, vooral wanneer u wilt controleren of een notificatie-instantie voor abonnementsberichten correct is gevormd. U kunt ook zien hoeveel actieve abonnementen er in elke container zijn geregistreerd, zodat u kunt controleren of er een abonnementslek is.

Beste praktijken voor CloudKit Dashboardgebruik

Om het meeste uit het CloudKit Dashboard te halen en gemeenschappelijke valkuilen te vermijden, volg deze aanbevelingen:

  • Altijd eerst werken in Ontwikkeling. Maak schemawijzigingen en test de invoer van gegevens in de Ontwikkelingsomgeving voordat ze tot Productie worden gepromoot. Zodra een schema in Productie is, worden veel veranderingen beperkt.
  • Back-up van uw Productiegegevens regelmatig. Gebruik de exportfunctie ten minste eenmaal per week, of vaker als uw app omgaan met high-turnover gegevens. Back-ups opslaan op een veilige, versioneerde locatie.
  • Gebruik beschrijvende recordnamen en veldnamen. Dit maakt het dashboard gemakkelijker om voor u en uw team te navigeren. Vermijd namen die te lang zijn (meer dan 255 tekens zijn niet toegestaan).
  • Probeer gebruik te maken van de filterbouwer. Gebruik bij het debuggen filters om records te isoleren die door een bekende aandoening zijn aangetast. Dit kan patronen onthullen die anders onopgemerkt zouden kunnen blijven.
  • Zet zonemachtigingen zorgvuldig in. Het dashboard waarschuwt u niet als u een zone te veel permissieve toegang geeft. Bekijk altijd dat wereldlezen of wereldschrijven opzettelijk is voor de gegevens in die zone.
  • Monitor telemetrie tijdens belastingstests.[ Bij het simuleren van zwaar gebruik, houdt u het Telemetrietabblad open om te zien of uw app CloudKit... aanvragen van de snelheidslimieten (die afhankelijk zijn van uw containerniveau). Als u pieken in de .Limit Exceed ..foutcode ziet, moet u mogelijk uw vragen optimaliseren of een hogere limiet aanvragen.
  • Gebruik het API Access tabblad voor server-naar-server sleutels.[ Als uw app een metgezel server heeft, kunt u hier API tokens genereren om die server toegang te geven tot CloudKit zonder gebruikersnaam. Bewaar deze tokens veilig.

Conclusie

Het CloudKit Dashboard is meer dan een eenvoudige data viewer . . Het is een volledig uitgeruste administratieve console die, wanneer goed gebruikt, kan dramatisch versnellen iOS ontwikkeling en de betrouwbaarheid van de gegevens te verbeteren. Door te begrijpen hoe u de interface navigeren, records en zones beheren, import en export uitvoeren, en hefboom monitoring mogelijkheden, je zowel efficiëntie en vertrouwen in uw app . Regelmatig dashboard gebruik moet deel uitmaken van elke CloudKit ontwikkelaar workflow, van vroege prototypering door productie onderhoud. Met de praktijken beschreven in dit artikel, je zult goed uitgerust zijn om uw app te beheren iCloud data opslag als een doorgewinterde pro.

Voor meer informatie, zie Apple