Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Menyiapkan ekstensi

Prasyarat

  • Visual Studio Code 1.85 atau yang lebih baru, di desktop. Ekstensi bekerja dengan menjalankan program aggrega dan tidak menyediakan versi yang dapat dijalankan peramban sebagai gantinya, sehingga ekstensi tidak berjalan di editor yang sepenuhnya berjalan di peramban web, seperti vscode.dev dan github.dev.
  • Kompiler aggrega, di mesin tempat ruang kerja Anda berada. Ekstensi menjalankan kompiler yang ditunjuk oleh pengaturan aggrega.server.binaryPath: path yang diawali ~/ (~\ di Windows) atau ${userHome} dibaca dari folder home Anda di mesin tersebut, path lainnya digunakan apa adanya, sedangkan nama biasa — bawaannya aggrega — dicari di PATH. Jika tidak menemukan satu pun, ekstensi menawarkan untuk mengunduhkannya untuk Anda, dan Aggrega: Select Compiler Version dapat mengubah versinya nanti; lihat Mendapatkan kompiler.
  • Folder yang dikenali Aggrega sebagai root ruang kerja, di folder yang Anda buka atau di atasnya. Aggrega membaca satu file di root proyek Anda — .aggrega-config.yaml, yang memuat blok workspace: — dan menelusuri ke atas dari folder yang dibuka untuk menemukannya. Menandai root dengan blok workspace: adalah pilihan yang eksplisit dan yang lebih disarankan; proyek yang belum pernah mendeklarasikannya tetap dapat dikenali melalui penanda lain, yang dibahas di referensi konfigurasi Aggrega sendiri bersama semua hal lain yang dapat dilakukan konfigurasi dalam proyek yang lebih besar.

Anda tidak perlu menyiapkan semua itu secara manual: lihat Halaman sambutan.

Memasang ekstensi

Pengenal ekstensi adalah aggrega-ai.aggrega, dan ekstensi ini tercantum di dua tempat:

Di editor, buka tampilan Extensions, cari Aggrega, lalu pasang entri yang pengenalnya aggrega-ai.aggrega.

Dari terminal, berikan pengenal tersebut ke program baris perintah Visual Studio Code:

Terminal window
code --install-extension aggrega-ai.aggrega

Ekstensi menampilkan teksnya sendiri — perintah, pengaturan, tampilan, dan pesannya — dalam bahasa tampilan yang digunakan Visual Studio Code, jika teks itu sudah diterjemahkan ke bahasa tersebut, dan dalam bahasa Inggris jika tidak; bahasa tampilan yang Anda ubah dengan Configure Display Language berlaku untuknya setelah editor dimulai ulang. Apa yang dilaporkan kompilator, termasuk diagnostiknya dan pertanyaan sebuah impor, sampai kepada Anda sebagaimana kompilator merumuskannya, seperti di terminal.

Mendapatkan kompiler

Ekstensi menjalankan kompiler yang ditunjuk aggrega.server.binaryPath, dan mencari satu kompiler sebelum menawarkan untuk mendapatkannya. Path dalam pengaturan yang diawali ~/ — ~\ di Windows — atau ${userHome} dibaca dari folder home Anda di mesin tempat ruang kerja Anda berada, sehingga di Linux dan macOS ~/.local/bin/aggrega menunjuk file yang diletakkan skrip instalasi di sana; path lainnya digunakan apa adanya. Nama biasa — bawaannya aggrega — dicari di PATH Anda, dan kanal output Aggrega menyebutkan file mana yang ditemukan dan versi yang dilaporkannya.

Langkah kompilator di halaman sambutan, ditandai belum selesai, yang menawarkan Use the compiler on my PATH, Point at a compiler I have, dan Download the compiler.

Jika tidak menemukan satu pun, ekstensi menawarkan untuk mengunduhnya — dari langkah kompiler di halaman sambutan, tempat Download the compiler berada di samping Use the compiler on my PATH dan Point at a compiler I have, dan dari notifikasi bahwa server bahasa tidak dapat dimulai karena tidak ada apa pun di path tersebut. Pengunduhan:

  • menawarkan rilis terbitan terbaru yang didukung ekstensi ini, yang dibangun untuk sistem operasi dan prosesor mesin tempat ruang kerja Anda berada — dalam jendela yang dibuka di mesin jarak jauh, kontainer, atau WSL, yaitu mesin tersebut. Releases menyertakan biner untuk Linux dan macOS pada x86 64-bit dan ARM 64-bit, serta untuk Windows pada x86 64-bit; di mesin lain mana pun pengunduhan ditolak, dengan menyebutkan mesin tersebut;
  • mengusulkan folder yang digunakan skrip instalasi Aggrega — ~/.local/bin di Linux dan macOS, %LOCALAPPDATA%\Programs\aggrega di Windows — tempat kompiler disimpan sebagai aggrega, atau aggrega.exe di Windows, dan memungkinkan Anda mengubahnya; versinya tercantum di judul pertanyaan;
  • meminta Anda mengonfirmasi versi dan file sebelum apa pun diunduh, lalu menampilkan kemajuan yang dapat Anda hentikan;
  • memeriksa file terhadap SHA256SUMS rilis, menghapus unduhan yang tidak cocok dan menyebutkannya, membuatnya dapat dieksekusi, dan menjalankannya sekali dengan aggrega version -o json. Hanya file yang lolos ketiganya yang ditempatkan, dan baru setelah itu aggrega.server.binaryPath diatur ke file tersebut, di pengaturan Anda sendiri.

Unduhan melewati proxy yang digunakan editor Anda untuk ekstensi, sebagaimana dikonfigurasi oleh pengaturan http.proxy dan http.proxyStrictSSL-nya. Jika daftar rilis atau sebuah file tidak dapat dibaca — Anda sedang offline, GitHub membatasi permintaan dari alamat Anda, atau permintaan ditolak — tidak ada yang diunduh, pengaturan dibiarkan apa adanya, dan satu kalimat menjelaskan alasannya.

Ekstensi hanya mengganti kompiler yang berhak digantinya: kompiler di folder bersama tersebut, atau kompiler yang diunduhnya sendiri, yang diingatnya di mesin tersebut dalam penyimpanannya sendiri, bukan dalam pengaturan. Jika diminta mengunduh untuk menimpa kompiler yang Anda letakkan di tempat lain, ekstensi menyatakan bahwa ia tidak pernah mengganti kompiler semacam itu dan menawarkan folder bersama sebagai gantinya.

Ekstensi tidak pernah meningkatkan versi dengan sendirinya. Untuk kompiler yang boleh digantinya, ekstensi membaca daftar rilis saat jendela dibuka dan memberi tahu, sekali untuk setiap versi, bahwa rilis yang lebih baru tersedia; ekstensi tidak menanyakan apa pun tentang kompiler yang Anda tunjuk sendiri.

Aggrega: Select Compiler Version mengubah versi yang Anda jalankan, dan mempertahankannya hingga Anda mengubahnya lagi. Perintah ini mencantumkan rilis yang didukung ekstensi ini, dari yang terbaru, dan menandai yang sedang digunakan. Sebelum apa pun diunduh, perintah ini memperingatkan bahwa kompiler tersebut digunakan oleh setiap ruang kerja di mesin ini, sehingga versinya berubah untuk semuanya, dan bahwa Release yang file kuncinya ditulis versi lain mungkin perlu menjalankan Pull lagi; Anda mengonfirmasi dengan Download and switch. Versi baru diunduh di samping versi saat ini dan diperiksa seperti unduhan lainnya, server bahasa dimulai di atasnya, dan baru setelah itu versi baru menggantikan versi sebelumnya. Jika server bahasa tidak dapat dimulai di atasnya, versi baru dihapus, versi sebelumnya tetap ada, dan server bahasa dimulai lagi di atas versi sebelumnya. Di jendela tanpa ruang kerja Aggrega yang terbuka, tidak ada server bahasa untuk dimulai, sehingga pemeriksaan versi menggantikannya dan pesannya menyatakan demikian. Perintah ini hanya mengganti kompiler di tempat yang boleh diganti oleh unduhan; untuk kompiler yang Anda letakkan sendiri di suatu tempat, perintah ini menyatakan demikian dan menawarkan folder bersama sebagai gantinya.