Iestatīšana

Uzbūvē HolyArrs no pirmkoda un atver to pārlūkā uz porta 6262.

Pirms sāc

• Go ar versiju, ko nosauc go.mod.
• Node 24 un npm.
• Terminālis repozitorija saknē.

C kompilators nav vajadzīgs. Būvējumi lieto CGO_ENABLED=0.

Būvē un palaid

1. Uzstādi tīmekļa lietotnes pakotnes:

   npm --prefix app/frontend ci

2. Uzbūvē tīmekļa lietotni:

   npm --prefix app/frontend run build

   Tev vajadzētu redzēt, ka būvēšana beidzas un app/frontend/dist piepildās ar failiem.

3. Uzbūvē programmu:

   go build -o bin/holyarrs ./app/backend/cmd/holyarrs

4. Palaid to ar savu konfigurācijas mapi:

   ./bin/holyarrs -config ./config

5. Atver http://localhost:6262.

   Tev vajadzētu redzēt pirmās palaišanas vedni. Izveido īpašnieka kontu.

Uzmanību

Programma iebūvē app/frontend/dist. Pēc tīmekļa lietotnes izmaiņas pirms programmas uzbūvē tīmekļa lietotni vēlreiz, citādi saņemsi vecās lapas.

-config pieņem mapi lokālajā diskā, un noklusējums ir /config. -addr maina klausīšanās adresi, un noklusējums ir :6262.

Strādā pie tīmekļa lietotnes

Atstāj programmu darbojamies. Otrā terminālī palaid izstrādes serveri:

npm --prefix app/frontend run dev

Izstrādes serveris pārlādējas pēc saglabāšanas un sūta API izsaukumus darbojošajai programmai. Savu izmaiņu pārlūkā tev vajadzētu redzēt 2 s laikā.

Izvēles

Lieto Makefile

Komanda	Dara
make ui	Uzstāda tīmekļa pakotnes un uzbūvē tīmekļa lietotni
make build	make ui, tad uzbūvē bin/holyarrs
make test	go test ar 25 min taimautu
make vet	go vet ./...
make docker	Uzbūvē attēlu kā holyarrs:dev
make e2e	Palaiž end-to-end testus

Ieslēdz aizturētu funkciju

Dažas funkcijas ir aizturētas un paliek izslēgtas. Nosauc tās HOLYARRS_FLAGS, atdalot ar komatiem:

HOLYARRS_FLAGS=subtitle_sites,ai_apps ./bin/holyarrs -config ./config

Lapas paslēpj izslēgtu funkciju, un tās maršrutu nav. Lietotāji par tām lasa sadaļā Aizturētās funkcijas.

Piepildi bibliotēku ar demonstrācijas datiem

Demonstrācijas rīks piepilda konfigurācijas mapi ar demonstrācijas kolekciju. Tas darbojas tikai ar apturētu HolyArrs un tikai ar mapi, ko tu atzīmēji kā laboratoriju. Atzīmē to vienreiz:

go run ./app/backend/tools/demo seed -config ./config -init-lab

Tad seed -config ./config pievieno demonstrācijas bibliotēku, bet seed -config ./config -reset-demo noņem tikai to, ko tas pievienoja. Multivides mapei jābūt /data/media, ja vien nenodod -force. Izstrādes rīki netiek iekļauti attēlā. Skaties Izstrādes rīki.

Ja tas nedarbojas

Simptoms. Lapas izskatās vecas pēc tam, kad mainīji tīmekļa lietotni. Cēlonis. Programma apkalpo to būvējumu, ko tā iebūvēja sevī. Risinājums. Palaid tīmekļa būvēšanu, tad Go būvēšanu, tad palaid programmu.

Simptoms. go build neizdodas, jo trūkst app/frontend/dist. Cēlonis. Tīmekļa lietotne vēl nav uzbūvēta. Risinājums. Vispirms izpildi 2. soli.

Simptoms. Programma saka, ka ports ir aizņemts. Cēlonis. Cits HolyArrs vai cita lietotne tur 6262. Risinājums. Nodod citu adresi: ./bin/holyarrs -config ./config -addr :6263.

Pieredzējušiem

Aizturēto funkciju slēdži

Slēdzis	Funkcija
row_title_stats	Izpētes rindu statistika īpašniekam
trakt_lists	Trakt saraksti
alert_channels_more	Paziņojumu kanāli papildus Discord un e-pastam
subtitle_sites	Subtitru vietnes un subtitru meklēšana
emby_signin	Pieteikšanās ar Emby
go_back	Soļi, lai atgrieztos pie iepriekšējās versijas

Lai pievienotu jaunu, reģistrē tā nosaukumu ar startup.RegisterFeature un pirms tā maršrutu reģistrēšanas pārbaudi startup.FeatureOn. Nosaukumi atrodas app/backend/internal/core/startup (feature.go).

Izstrādes rīki

Rīks	Komanda	Dara
Demo	go run ./app/backend/tools/demo <command> -config DIR	Darbojas ar apturēta HolyArrs konfigurācijas mapi. Komandas: inspect (skaitļi), fingerprint, query "SELECT ..." (tikai lasīšana), doctor, seed, showcase
Viltota subtitru vietne	go run ./app/backend/tools/fakesubs	Testiem apkalpo viltotas subtitru vietnes uz 127.0.0.1:18727. -addr to pārvieto; -accounts-addr pievieno kontu vietņu viltojumus
Maršrutu saraksts	go run ./app/backend/tools/apidoc	Pārraksta API maršruti

Uzbūvē attēlu

docker build --file deploy/Dockerfile --tag holyarrs:dev .
docker run -p 6262:6262 -v ./config:/config holyarrs:dev

Attēls sākas ar FROM scratch un satur programmu, CA sertifikātus un licences. Tas palaiž -config /config -addr :6262.

Saistītais

• Dalība izstrādē
• Testēšana
• Moduļi