Projektna mapa

graph TD
  P[Projektna mapa] --> A[name.acproj]
  P --> S[source: izvorne datoteke podatkovne zbirke]
  P --> D[delivery: nastavitve izdaje]
  P --> B[build: rezultati, brez nadzora različic]
  P --> O[obj: delovno stanje, brez nadzora različic]
  S --> BC[build: konfiguracija z ACCDB in ACCDE]
  D --> BD[build: Delivery, izdaja za način z zaganjalnikom in mapo deploy]
  B --> BC
  B --> BD

Projekt WKL Office SDK je mapa s projektno datoteko. Ta stran pokaže, katere datoteke so v njej, katere sodijo pod nadzor različic in kateri ukaz posamezno datoteko zapiše. Podrobnosti o vsaki datoteki so na njeni referenčni strani.

• Izvorne datoteke namesto podatkovne zbirke. Pod nadzor različic sodijo projektna datoteka, source\ in delivery\. Podatkovna zbirka ob vsaki gradnji nastane znova iz izvornih datotek.
• Rezultati in delovno stanje ostanejo na računalniku. build\ in obj\ sta navedena v datoteki .gitignore, ki jo ustvari new.
• Skupni deli so zunaj projekta. Skupne predloge in pakete izdaj SDK najde prek nastavitev SDK ali spremenljivk okolja; v projekt jih ne kopira.
• Lastna imena map. source\, build\ in delivery\ so privzeta imena; projektna datoteka lahko navede druge mape (SourceRoot, BaseOutputPath, DeliveryRoot), za nove projekte pa jih določite v nastavitvah SDK.
• V mapi ni zaupnih podatkov. Potrdila so navedena samo s prstnim odtisom.

<project folder>\
  <name>.acproj                    project file
  .gitignore                       build/ and obj/
  .vscode\tasks.json               tasks for Visual Studio Code
  source\                          sources of the database (folder set by SourceRoot)
    references.json
    ...
  delivery\                        delivery settings, versioned (folder set by DeliveryRoot)
    delivery-settings.json
    <profile>.profile.json
    <profile>.bootstrapper.json
  build\                           results, not versioned (folder set by BaseOutputPath)
    <configuration>\
      <name>.accdb
      <name>.accde
    Delivery\<profile>\
      Wkl.Bootstrapper.exe
      bootstrapper.json
      deploy\
  obj\                             state of this workstation, not versioned
    wkl-state.json
    wkl-sdk.lock

• Prvotna podatkovna zbirka ne sodi v repozitorij. Obstoječo datoteko ACCDB z njenega dosedanjega mesta enkrat izvozite v izvorne datoteke z ukazom export -d (vadnica) ali z ukazom Nov projekt iz te podatkovne zbirke… v dodatku; migrate ustvari nov projekt v prazni mapi. Od takrat naprej je podatkovna zbirka rezultat gradnje.
• build\ in obj\ nikoli nista pod nadzorom različic. deliver mapo izdaje vsakič zapiše na novo. Namestitveni paket, ki ga želite obdržati, pred naslednjim deliver shranite drugam.
• delivery\ potrdite z git. commit zajame samo projektno datoteko, njeno datoteko .gitignore in mapo z izvornimi datotekami.
• Potrdila samo s prstnim odtisom. msi --sign pričakuje prstni odtis potrdila iz shrambe potrdil sistema Windows. V projektu ni ne potrdila ne gesla.
• Skupni deli zunaj projekta. delivery-settings.json navaja pakete izdaj s potjo, ki lahko vsebuje %WKL_PACKAGES%. Skupne predloge SDK najde prek WKL_ACCESS_TEMPLATES (predloge).
• Druge mape lahko uporabljate prosto. Map, kot so tests\, tools\ ali docs\, SDK ne bere. Pod nadzor različic jih postavite z git.

Projektna mapa ni nujno koren repozitorija. SDK uporabi delovno kopijo git ali Subversion, ki je projektni datoteki najbližja med nadrejenimi mapami. commit zajame samo projektno datoteko, njeno datoteko .gitignore in mapo z izvornimi datotekami, tudi če so za potrditev pripravljene še druge datoteke v repozitoriju. Preizkusni projekt z lastno projektno datoteko je lahko znotraj projektne mape: build\, obj\ in zaklepanje vedno pripadajo mapi svoje projektne datoteke.

<repository>\
  client\                          other parts, not read by the SDK
  installer\
  docs\
    images\                        source images of the manual
  access-admin\                    project folder of the application
    DbGwAdmin.acproj
    .gitignore
    source\
      resources\images\            shared images of the database
    delivery\
    assets\                        files of the application that are not part of the database
    tests\                         test project, a project folder of its own
      DbGwAcceptance.acproj        <Template>..\DbGwAdmin.acproj</Template>
      .gitignore
      source\
      build\                       results of the test project, not versioned
      obj\                         state and lock of the test project, not versioned
    build\
    obj\

• Ena projektna datoteka na mapo. Predlogo, navedeno z mapo, SDK najde le, če je v tej mapi natanko ena datoteka .acproj. Tudi dodatek projekt odprte podatkovne zbirke išče v njeni mapi in do tri ravni višje. Preizkusni projekt zato dobi svojo podmapo. Če je poleg glavnega projekta še druga datoteka .acproj, check sporoči, da predloge .. ni mogoče najti.
• Preizkusni projekt je samostojen projekt. Gradi v tests\build\, stanje uskladitve in zaklepanje hrani v tests\obj\, potrdite pa ga z njegovim lastnim ukazom commit. Glavni projekt mape tests\ ne bere. Glavni projekt navedite kot predlogo z relativno potjo, najbolj nedvoumno kar z datoteko: <Template>..\DbGwAdmin.acproj</Template>. Njegove izvorne datoteke se tako pridružijo izvornim datotekam preizkusnega projekta (predloge).
• V source\ so samo izvorne datoteke podatkovne zbirke. Vsaka datoteka v source\resources\images\ ob gradnji postane skupna slika podatkovne zbirke (galerija slik v programu Access), export pa tam izbriše vsako datoteko, ki je podatkovna zbirka ne vsebuje. Drugih datotek v mapah objektov check ne naloži, ampak jih sporoči kot opozorilo.
• Druge datoteke shranite tam, kjer jih uporabljate. Datoteke, ki sodijo k aplikaciji, ne pa k podatkovni zbirki, na primer logotipe za namestitveni program ali izvirnike njegovih slik, shranite v poljubno mapo znotraj projektne mape, na primer assets\. Slike priročnika sodijo k priročniku. Teh map SDK ne bere; pod nadzor različic jih postavite z git.

• Referenčni priročnik projektne datoteke – lastnosti, konfiguracije in predloge datoteke .acproj
• Konfiguracije gradnje in profili izdaje – kaj določa konfiguracija in kaj profil
• Razporeditev in formati izvornih datotek – vsebina mape source\ in potek gradnje
• delivery-settings.json – različica in paketi izdaj, ki so skupni vsem profilom, ter profili
• Referenčni priročnik ukazne vrstice – kaj natančno naredijo new, commit, deliver in msi
• Priprava izdaje aplikacije z WKL Office SDK – priprava izdaje korak za korakom