Bagikan melalui


Memulai emulator CLI Static Web Apps

Penting

Untuk meningkatkan keamanan penyebaran dari CLI Static Web Apps, perubahan yang melanggar diperkenalkan yang mengharuskan Anda untuk meningkatkan ke versi terbaru (2.0.2) dari CLI Static Web Apps pada 15 Jan 2025.

Static Web Apps adalah platform berbasis cloud yang menghosting dan menjalankan aplikasi web Anda. Saat menjalankan aplikasi secara lokal, Anda memerlukan alat khusus untuk membantu Mempertanyakan bagaimana aplikasi Anda akan berjalan di cloud.

Static Web Apps CLI (SWA CLI) menyertakan emulator yang meniru bagaimana aplikasi Anda akan berjalan di Azure, tetapi sebaliknya berjalan secara eksklusif di komputer Anda.

Perintah swa start meluncurkan emulator dengan pengaturan default. Secara default, emulator menggunakan port 4280.

Untuk informasi selengkapnya tentang perintah individual, lihat referensi CLI.

Menyajikan file statis dari sistem file Anda

SWA CLI memungkinkan Anda untuk langsung melayani konten statis Anda dari sistem file Anda tanpa alat lain yang diperlukan. Anda dapat melayani konten statis dari direktori Anda saat ini atau folder tertentu.

Melayani dari... Perintah Catatan
Folder saat ini swa start Secara default, CLI memulai dan menyajikan konten statis (file HTML, gambar, skrip, dan CSS) dari direktori kerja saat ini.
Folder tertentu swa start ./my-dist Anda dapat mengambil alih perilaku untuk memulai emulator dengan folder aset statis yang berbeda.

Menggunakan server pengembangan

Saat mengembangkan front-end aplikasi, Anda mungkin ingin menggunakan server pengembangan default kerangka kerja. Menggunakan server kerangka kerja memungkinkan Anda memanfaatkan manfaat seperti pemuatan ulang langsung dan penggantian modul panas (HMR).

Misalnya, pengembang Angular sering menggunakan ng serve atau npm start untuk menjalankan server pengembangan.

Anda dapat menyiapkan Static Web Apps SWA CLI untuk memproksi permintaan ke server dev, yang memberi Anda manfaat dari CLI kerangka kerja Anda sekaligus bekerja dengan Static Web Apps CLI.

Ada dua langkah untuk menggunakan server dev kerangka kerja bersama dengan SWA CLI:

  1. Mulai server dev lokal kerangka kerja Anda seperti biasa. Pastikan untuk mencatat URL (termasuk port) yang digunakan oleh kerangka kerja.

  2. Mulai SWA CLI di terminal baru, lewati URL server dev.

    swa start <DEV_SERVER_URL>
    

Catatan

Pastikan untuk mengganti <DEV_SERVER_URL> tempat penampung dengan nilai Anda sendiri.

Luncurkan server dev

Anda dapat menyederhanakan alur kerja Anda lebih lanjut dengan meminta SWA CLI meluncurkan server dev untuk Anda.

Anda dapat meneruskan perintah kustom ke --run parameter ke swa start perintah .

swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>

Berikut adalah beberapa contoh memulai emulator dengan beberapa kerangka kerja yang berbeda:

Kerangka Perintah
React swa start http://localhost:3000 --run "npm start"
Blazor swa start http://localhost:5000 --run "dotnet watch run"
Jekyll swa start http://localhost:4000 --run "jekyll serve"

Anda juga dapat menggunakan --run parameter jika Anda ingin menjalankan skrip kustom saat meluncurkan server dev.

swa start http://localhost:4200 --run "./startup.sh"

Dengan menggunakan perintah di atas, Anda dapat mengakses aplikasi dengan layanan yang ditimulasi dari http://localhost:4280

Langkah berikutnya