Pohjaan perustuvien sovellusten lähdekooditiedostojen tarkasteleminen

2025-03-25

Käytä pohjaan perustuvan sovelluksen lähdekoodia tarkastellaksesi tekijöiden Power Apps Studiossa tekemiä muutoksia. Luotu pohjaan perustuvan sovelluksen YAML-koodi on vain luku -muotoa, eikä sitä voi muokata. Kaikki tiedostoon tehdyt muutokset ohitetaan ja saatetaan menettää.

YAML-mallia kehitetään aktiivisesti, ja sen sisältö saattaa olla puutteellinen.

*.pa.yaml-tiedostojen nykyinen staattinen rakenne on saatavilla täällä.

Power Fx ja YAML ovat Power Apps -lähdekoodissa käytettävät kielet. YAML:ia arvostetaan sen ihmisen luettavan muodon vuoksi, ja sen etuja on laaja valikoima editoreja, työkaluja ja kirjastoja manipulointiin.

Lähdekooditiedostojen käyttäminen

Voit käyttää lähdekooditiedostoja, jos käytät Dataversen Git-integraatiota, jolloin .msapp-tiedostoja ei tarvita

Power Apps Studio luo pohjaan perustuvien sovellusten lähdekoodin, joka tallennetaan *.pa.yaml-tiedostoina .msapp-tiedostoon. .msapp-tiedosto on binaaritiedosto, joka sisältää kokoelman tiedostoja, mukaan lukien lähdekoodin.

Vinkki

Jos haluat käyttää sovelluksen elinkaaren hallintaa (ALM) tehokkaasti, on suositeltavaa käyttää ratkaisuja. Pohjaan perustuvien sovellusten paketti ei tue ALM:ää, ja sitä tulisi käyttää vain tuonnin ja viennin perusominaisuuksiin, kun Dataverse ei ole käytettävissä.

Voit myös hakea lähdekooditiedostot joko .msapp-tiedostosta tai Power Platform CLI:n avulla.

*.pa.yaml-tiedostot löytyvät puretun .msapp-tiedoston \Src-kansiosta.

Tärkeää

Vain puretun .msapp-tiedoston \Src-hakemistossa sijaitsevat tiedostot on tarkoitettu käytettäväksi lähdekoodin hallinnan kanssa. .msapp-tiedoston JSON-tiedostoja ei tule käyttää lähdekoodina, koska ne eivät ole vakaita tallennus- ja latausjaksojen välillä.

Lataa ja pura pa.yaml-tiedostot Power Platform CLI:n avulla

Muodosta yhteys ympäristöösi Power Platform CLI:n avulla ja käytä sitten seuraavia komentoja:

Jos haluat luetella pohjaan perustuvat sovellukset nykyisessä ympäristössäsi, käytä komentoa: pac canvas list.
Voit purkaa lähdekooditiedostot komennolla: pac canvas download määrittämällä myös parametrin -d.

Lähdekooditiedostojen purkaminen .msapp-tiedostosta

Voit purkaa lähdekooditiedostot .msapp-tiedostosta kahdella tavalla:

Pura .msapp-tiedosto manuaalisesti.
Vaihtoehtoisesti voit käyttää seuraavaa komentoa:

 Expand-Archive -Path "C:\path\to\yourFile.msapp" -DestinationPath "C:\path\to\destination"

.msapp-tiedoston tiedostorakenne

Jos kyseessä on vanha .msapp-tiedosto, jossa, jossa ei ole \src-kansiota, luo lähdekooditiedostot seuraavasti:

Tuo ja tallenna uudelleen ja lataa uusi .msapp-tiedosto Power Apps Studioon.
Tämän jälkeen voit jatkaa lähdekooditiedostojen purkamista.

\src-kansiossa on seuraavat tiedostot ja kansiot:

App.pa.yaml: edustaa sovellusta.
[näytön nimi].pa.yaml: Yksi tiedosto kullekin näytölle.
\Component: Kansio, joka sisältää yhden tiedoston kullekin komponentille ja jota edustaa [komponentin nimi].pa.yaml.

Vain \src-kansiossa olevia *.pa.yaml-tiedostoja voidaan käyttää lähdekoodina. Muita tiedostoja ei tule käyttää lähdekoodina.

Power Apps YAML -rakenteen versiot

Tällä hetkellä Power Apps -lähdekoodista on kolme rakenneversiota:

Muodon nimi	Tiedoston tunniste	Description
Kokeellinen	*.fx.yaml	Kokeellisen Power Appsin Git-versionhallinnan ja pac canvas unpack -komennon käyttämä versio – ei enää kehitteillä.
Ennakkojulkaisu	-	Koodinäkymän, koodin kopioinnin ja liittämisen käyttämä versio. Tässä rakenteessa ei ole versiotietoja, joten se ei sovellu versionhallintaan. Kun koodinäkymä on yleisesti käytettävissä (GA), se siirtyy lähdekoodin esiversiomuotoon.
Lähdekoodi	*.pa.yaml-tiedostot	Sisältää lähteen hallinnan parannuksia ja versiotietoja, ja sitä kehitetään aktiivisesti.

Kokeellinen muoto (*.fx.yaml)

Tässä rakenteessa kuvataan kokeellinen muoto, jota Power Platform CLI käyttää pohjaan perustuvien sovellusten käsittelemiseen ja lähdekoodimuotoon muuntamiseen. Tätä muotoa ei enää kehitetä aktiivisesti.

Et voi muuntaa *.fx.yaml-tiedostoja suoraan uusiin muotoihin. Jos haluat muuntaa vanhempia sovelluksia, pakkaa pohjaan perustuva sovellus .msapp-tiedostoksi ja tuo se Power Apps Studioon.

Esikatsele

Koodinäkymä käyttää tätä versiota esiversiojakson ajan. Se on suunniteltu luomaan Power Apps Studiossa pohjaan perustuvia sovelluksia, joiden avulla ohjausobjekteja on helppo kopioida ja liittää. Tässä versiossa lähdekoodia käytetään Power Apps Studiossa muuntamisen sijaan, esimerkiksi kokeellisessa muodossa.

Esiversion aikana käytetty muoto oli tilapäinen eikä sitä enää käytetä. Voit liittää koodia esiversiomuodosta.

Tässä ovat kokeellisesta muodosta tehdyt muutokset:

ZIndex-ominaisuuden poisto: ZIndex-ominaisuus poistetaan. Sen sijaan näyttö esitetään ohjausobjektien joukkona. Säätimien järjestys määrittää niiden pinoamisjärjestyksen. Normaalit ohjausobjektit on järjestetty nousevaan järjestykseen, kun taas reagoivat ohjausobjektit on järjestetty laskevaan järjestykseen.
JSON-objektin esityksen korvaaminen: As-syntaksia ei enää käytetä ohjausobjektityypin määrittämiseen. Sen sijaan ohjausobjektin nimitunnisteen vasen puoli pysyy yksilöllisenä. Vain oletusarvoista poikkeavat ominaisuudet sarjoitetaan. Kaksi uutta ominaisuutta määrittävät ohjausobjektin tyypin ja oletusarvot:

Ohjausobjekti: Edustaa YAML:n ohjausobjektityyppiä.
Variantti: Tunnistaa ohjausobjektityypin variantin, joka voi muuttaa ominaisuuksien oletusarvoja, lisätä tai poistaa ominaisuuksia taikka muuttaa ohjausobjektin toimintaa tai asettelua.

Näitä ominaisuuksia käytetään ohjausobjektien esiintymien luomiseen, eivätkä ne hyväksy Power Fx -lausekkeita.

Lähdekoodi (*.pa.yaml)

Tärkeää

Pohjaan perustuvien sovellusten YAML-lähdekoodia kehitetään aktiivisesti. Sisältö on epätäydellistä ja se voi muuttua.
.pa.yaml-tiedostot ovat vain luku -muotoisia, ja niitä tulee käyttää vain Power Apps Studiossa tehtyjen muutosten tarkistamiseen. Näitä tiedostoja ei käytetä, kun sovellusta ladataan.
Ulkoista muokkaamista, yhdistämistä ja ristiriitojen ratkaisua ei tueta.

Tämä rakenne on suunniteltu lähdekoodin hallintaan ja se sallii yhden YAML-tiedoston käytön.

Edellisen muodon päivityksiä ovat:

Ylimmän tason solmuelementtien ryhmittely:
- Ylätason avainsanat "Sovellus" ja "Näytöt" ovat esimerkkejä siitä, miten elementit ryhmitellään nyt ylätason solmuun.
Ohjausobjektin version määritys:
- Voit nyt määrittää ohjausobjektin version käyttämällä ohjausobjektin avainsanaa ja sen jälkeen operaattoria @. Jos versiota ei ole määritetty, käytetään ohjausobjektin uusinta versiota. Versiota käytetään lähdekoodin ominaisuuksien sarjoituksen purkamiseen. Ohjausobjektin suorituspalveluversio määräytyy sisällöntuottamisversion mukaan.
Yksinkertaistetut varianttien nimet:
- Kaikki ohjausobjektit eivät edellytä varianttia.
Johdonmukainen ZIndex kaikille ohjausobjekteille:
- Kaikki ohjausobjektit käyttävät nyt nousevaa järjestystä ZIndex-arvon määrittämiseen alkaen arvosta 1. Tämä toiminnallisuus vastaa CSS 2 -määritystä.