Hoppa till innehållet
Studio

Routster Studio

Bygg en modul

En modul lägger till en sida bredvid kartan i Studio: ett verktyg som banläggaren öppnar. Den läser tävlingen, frågar Studio efter vägval och efter vad kartan har ritat, visar linjer över kartan och föreslår ändringar som banläggaren godkänner, var och en som ett steg att ångra. Alla moduler på modulsidan är byggda så.

Du kan bygga en modul, köra den i din egen Studio och publicera den från utgivarsidan.

Det här behöver du

  • .NET 10 SDK.
  • Routster Studio med host API 1.16 eller nyare, som mallen bygger för. Studio är i tidig åtkomst: be om en version på startsidan. Studio 0.18.0, från den 11 november 2026, har det.
  • Lite C#. En moduls sida är en Avalonia-kontroll som byggs i kod.
Be om tidig åtkomst

Från ingenting till en modul på skärmen

  1. 1 Installera mallen och verktyget

                      dotnet new install Routster.Studio.Templates
    dotnet tool install -g Routster.Studio.ModuleTool
                    

    Båda kommer från nuget.org, liksom uppdateringar av dem.

  2. 2 Skapa en modul

                      dotnet new routster-module -n LegLengths --id se.myclub.leg-lengths --title "Leg lengths"
                    

    Id:t är modulens för alltid: en domän du äger, baklänges, och sedan modulens namn, med små bokstäver. Titeln är det banläggaren ser.

  3. 3 Kör den i din Studio

                      routster-module run LegLengths
                    

    Det här bygger modulen, packar den med en nyckel som skapas för din dator, lägger den i din Studio och öppnar Studio. Modulens ikon finns i listen till höger i fönstret, och dess sida ritar banan som visas från kontroll till kontroll. Ändra i Page.cs, avsluta Studio och kör igen.

  4. 4 Kontrollera den

                      routster-module validate LegLengths
                    

    Det här kontrollerar det en granskare kontrollerar först: att Studio godtar manifestet, att namnet och sammanfattningen finns på alla fyra språken, att ikonen är en SVG-bana och att modulens DLL finns.

Utvecklarläge

Första körningen slår på utvecklarläget i din Studio: din nyckel läggs i Studios developer-keys.json, och din modul får märket Developer på Studios modulsida. Bara din egen Studio litar på den nyckeln. Inget som signerats med den når någon annans Studio: Studio tar aldrig emot en katalog, en nedladdning eller en uppdatering på en utvecklarnyckel.

Vad en modul består av

manifest.json
Dess id, version, namn och sammanfattning på varje språk, dess ikon, vilket host API den behöver, om den kostar, och var den startar.
Module.cs
Implementerar IStudioModule. Metoden Register lägger till modulens sida.
Page.cs
Sidan: en Avalonia-kontroll som byggs i kod.
Text.cs
Varje ord modulen visar, på engelska, svenska, franska och tyska.

Projektet refererar till Routster.Studio.Sdk, som innehåller host API:t och byggsteget som lägger upp modulens mapp, och till Avalonia. Studio har redan båda laddade, så ingen av dem hamnar i ditt paket. En modul får ta med andra bibliotek skrivna i hanterad kod; de läggs i paketet bredvid den. Maskinkod får den inte ta med.

Vad Studio ger en modul

Allt en modul får röra är IModuleHost, i paketet Routster.Studio.Sdk, med dokumentationen visad i din editor. I version 1.16:

AddInspectorPage
En sida i listen: ett id, en titel, en Lucide-ikon och en funktion som skapar vyn.
Event
Den öppna tävlingen, skrivskyddad: kartans skala, banan som visas och dess kontroller, varje kontroll med sina beskrivningsrutor, varje bana med sina kontroller, varje variant av en gafflad bana, och händelser för att följa ändringar. Sedan 1.11 har en banas kontroller sitt nummer på kontrollbeskrivningen, och DescriptionSymbolPng ritar en beskrivningssymbol så som tävlingens standard skriver ut den. Sedan 1.12 säger Pages var varje bana skrivs ut: kartans del, papperet innanför marginalerna och utskriftsskalan. Sedan 1.13 fyller Expand i en texts fält så som de skrivs ut på en bana, och PageImage ritar en banas sida så som bara kartan har den, för en modul som letar efter tom mark. Sedan 1.15 ger Ink en tryckfärg så som Studio visar den på skärmen.
Routes
Studios vägvalsberäkning för banan som visas, en bana vid namn eller en variant av en gafflad bana: varje sträckas bästa vägval och alternativen, i meter när skalan är känd. På en sprintkarta är det bästa vägvalet det kortaste; på en skogskarta i OCAD är det det snabbaste genom underlag, vegetation och stigning. CostAsync ger vad varje sträcka kostar att springa, bit för bit. Beräkningen är Routster Analyses, så en modul har aldrig en egen.
Georeference
Mellan kartmillimeter och latitud och longitud, när kartan är georefererad.
Platform
Den inloggade banläggarens egna lopp i Routster Analyse och deras GPS-spår, skrivskyddat, hämtat när banläggaren trycker på något. SignInAsync öppnar Studios inloggning.
MapReader
Vad en OCAD-karta har ritat: objekten nära några punkter; linjerna, ytornas kanter och punktobjekten i ett område; och om det är en sprint- eller skogskarta. Sedan 1.14 läser LayoutOfAsync vilken OCAD-fils layout som helst, dess layoutobjekt och bilder, i filens millimeter på papper.
MapAnalysis
Den öppna kartans passerbarhetsmasker, för en modul som analyserar marken själv.
Editor
Små ändringar, var och en ett steg att ångra under ett namn du ger: beskrivningsrutor, kontrollkoder, en bild bredvid banan. Sedan 1.12 lägger PlaceLayout ut texter, linjer, rektanglar, ellipser, bilder och vitt på alla banor eller några, allt eller inget i ett steg, och ReadLayout läser tillbaka dem; sedan 1.13 placerar den också en banas kontrollbeskrivning.
Propose, ProposeSet
Banor som banläggaren har godkänt, skapade som ett steg att ångra; en kontroll på samma plats som en som redan finns i tävlingen är den kontrollen. Sedan 1.9 gör HideFromReports en bana för arrangörerna, utanför rapporter och uppladdningen till Analyse, vilket banläggaren kan ändra i banans egenskaper.
ShowOnMap, ShowOverlay, ShowArea, ShowControl
Linjer och en bild över kartan medan din sida är öppen, aldrig utskrivna; att visa ett område; och, sedan 1.10, att markera en kontroll så som ett tryck på kartan gör. Sedan 1.11 kan en linje ha en etikett, vad den är, dess tid och längd, som Studio visar så som banläggaren valt.
Settings
Din moduls egna värden för den öppna tävlingen, sparade bredvid den.
DataDirectory
Sedan 1.12 en egen mapp för din modul på datorn, för det den sparar mellan tävlingar. Den följer inte med en tävling.

En mindre version lägger bara till: en modul byggd för 1.3 fungerar i en Studio med 1.16. En större version aviseras en utgåva i förväg.

Reglerna en modul lever efter

  1. Föreslå, ändra aldrig bakom banläggarens rygg. En ändring sker när banläggaren trycker på din knapp, genom Editor eller Propose, som ett steg som går att ångra.
  2. Ändra aldrig hur marken klassas för vägval. Vägvalen är Routster Analyses, så att vägvalet en banläggare bedömer i Studio är det en löpare får se efteråt. En modul får lägga till egna hinder i sin egen analys, och inget mer.
  3. Inga gissade siffror. När skalan eller geometrin är okänd, visa inga meter. Routes ger inga då; gör likadant med dina egna.
  4. En mening för allt som går fel. Med det enda som ska göras åt det. Aldrig en kod eller en stackspårning.
  5. Studios utseende. Studios tema formger dina kontroller. Använd dess klasser (primary, ghost, small, muted, card), bara Lucide-ikoner, rubriker skrivna som vanliga meningar, inga utropstecken.
  6. Fyra språk. Varje ord en modul visar finns på engelska, svenska, franska och tyska, precis som Studios egna.
  7. Nätverket är inte ditt. En modul fungerar utan nät. Det den behöver från en server går genom Studio, inte genom en egen HTTP-klient.

Att lägga en modul i butiken

En banläggare installerar bara paket som Routster har byggt, så en modul kommer in i butiken så här. Bli utgivare på utgivarsidan, med ditt Routster-konto, och skicka in modulens id, ett publikt GitHub-repo och den commit som ska publiceras. Välj hur den betalas: gratis; ett pris, som betalas en gång, där Routster behåller 10 % exklusive moms och du får resten; eller prenumerationsprogrammet, där modulen ingår i alla Routster-planer och du får en månatlig andel av en pott, fördelad efter hur många betalande prenumeranter som använde den den månaden. Routster betalar dig varje månad med banköverföring. Någon på Routster läser källkoden vid den commiten och godkänner den, ber om ändringar eller säger varför inte. Sedan bygger Routster din commit på en ren maskin, signerar den och publicerar den med ditt namn på. En modul får inte konkurrera med någon av Routsters egna som säljs eller ingår i en plan; att bygga vidare på en är välkommet, och är du osäker, fråga innan du börjar.

Publicera en modul

Mallen, verktyget och SDK:t har MIT-licens. Den gäller utvecklarpaketen, inte Studio.

Frågor, eller något Studio inte ger en modul som din skulle behöva? contact@routster.se