Extension VS Code
Extension Phillip cho VS Code đưa tài nguyên Tara, task Bandum của bạn và issue đang làm vào Activity Bar. Trang này chỉ cách cài, các phần của extension và cách xử lý khi nó không tìm thấy ph.
Extension không gọi API riêng và không giữ token. Nó chạy lệnh ph giúp bạn, với --json để lấy dữ liệu hoặc mở Terminal tích hợp cho lệnh dài, nên đăng nhập, token và quyền đều là của ph. Vì vậy bạn cần cài và đăng nhập Phillip trước (xem Cài đặt chi tiết), rồi mở thư mục repo của dự án, có origin và có phillip.lock nếu dự án dùng Tara. Nếu extension báo "the … output from ph is not JSON" thì Phillip còn cũ, bạn cập nhật lên.
Cài extension
Extension là một file .vsix do Tara phát cạnh gói Phillip (https://tara.phillipcli.cloud/phillip/phillip-vscode-<phiên bản>.vsix, hoặc phillip-vscode-latest.vsix cho bản mới nhất; https://tara.phillipcli.cloud/phillip/latest.json ghi phiên bản hiện tại ở mục vscode). Bạn tải về và cài từ dòng lệnh:
curl -fsSLo phillip-vscode.vsix https://tara.phillipcli.cloud/phillip/phillip-vscode-latest.vsix
code --install-extension phillip-vscode.vsixNếu Tara của bạn bắt đăng nhập mới được tải, bạn đăng nhập Tara trước rồi mở cùng địa chỉ trên trình duyệt để lưu file.
Hoặc trong VS Code, bạn mở Extensions, bấm menu ... rồi chọn Install from VSIX.... Nếu chưa cài hoặc chưa đăng nhập Phillip, extension báo rõ và có nút mở terminal để chạy ph setup.
Extension có gì?
| Phần | Nội dung | Lệnh ph phía sau |
|---|---|---|
| Panel Tara | Tài nguyên đã cài (từ phillip.lock), bản mới, cảnh báo bản bị thu hồi. Tìm, thêm, cài và nâng cấp tài nguyên | ph tara list, outdated, search; add, install, upgrade |
| Panel Bandum: my tasks (bandum: task của tôi) | Task gán cho bạn theo trạng thái, task cần sửa lên trước. Nút trên dòng: bắt đầu, kiểm thử tự động, kiểm thử tay, mở PR | ph bandum board --mine; start, verify, test, pr |
| Status bar | Dạng GH-12 · in progress. Issue suy ra từ nhánh feature/GH-<n>-..., trạng thái lấy từ board. Bấm để mở issue | git và board đã tải |
ph tara listNAME VERSION STATUS SOURCEagent-ba 1.1.1 dependency of harness-rnd-sdlcagent-dev 1.1.1 dependency of harness-rnd-sdlcagent-devops 1.1.1 dependency of harness-rnd-sdlcagent-docs 1.1.1 dependency of harness-rnd-sdlcagent-plan 1.1.1 dependency of harness-rnd-sdlcagent-po 1.1.1 dependency of harness-rnd-sdlcagent-reviewer 1.1.1 dependency of harness-rnd-sdlcagent-sa 1.1.1 dependency of harness-rnd-sdlcagent-security 1.1.1 dependency of harness-rnd-sdlcagent-test 1.3.2 dependency of harness-rnd-sdlcagent-uiux 1.1.1 dependency of harness-rnd-sdlcharness-rnd-sdlc 1.5.3 required by the projectkit-ryoma-session 1.0.2 dependency of harness-rnd-sdlckit-scm-github 1.3.0 dependency of harness-rnd-sdlckit-sdlc-guard 1.1.1 dependency of harness-rnd-sdlcprompt-release-note 1.0.2 dependency of harness-rnd-sdlcskill-sdlc 1.5.1 dependency of harness-rnd-sdlcRequirements: harness-rnd-sdlc@^1.5.0Nếu task đã có PR đang mở thì dòng task có nút mở PR, menu chuột phải cũng có. Muốn tạo PR từ nhánh hiện tại, bạn dùng lệnh Phillip: Create PR/MR from the current branch (ph bandum pr) (phillip: Tạo PR/MR...) (tương ứng ph bandum pr). Dự án chưa dùng Tara, tức chưa có phillip.lock, thì panel Tara hiện hai mục Initialize with a harness (ph init …) (khởi tạo bằng harness) (ph init) và Find and add resources (tìm và thêm tài nguyên).
Khi workspace có nhiều thư mục, extension chọn thư mục dự án theo file đang mở, rồi theo thư mục có phillip.lock. Bạn đổi sang file ở thư mục khác thì panel và status bar tự làm mới. Mọi lệnh đều có trong Command Palette với tiền tố Phillip:, ví dụ Phillip: Refresh (phillip: Làm mới) và Phillip: Set up (ph setup) (phillip: Thiết lập (ph setup)).
Các cài đặt
| Cài đặt | Mặc định | Ý nghĩa |
|---|---|---|
phillip.path | ph | Đường dẫn tới lệnh ph. Để mặc định thì extension tự tìm |
phillip.bandumUrl | http://localhost:8070 | Địa chỉ web Bandum, cùng ý nghĩa với PHILLIP_BANDUM_URL. Nếu bạn dùng Bandum online của tổ chức thì đặt địa chỉ đó |
Đã cài Phillip mà extension vẫn báo chưa cài
VS Code mở từ Dock hoặc menu Start thường có PATH tối giản, không chứa thư mục bin toàn cục của npm. Trong khi đó ph cần node nằm trong PATH. Extension tự tìm ph theo thứ tự: giá trị phillip.path nếu bạn đã đặt, PATH của VS Code, PATH của login shell, rồi các thư mục hay gặp như ~/.npm-global/bin, /opt/homebrew/bin, thư mục bin của prefix npm, và %APPDATA%\npm trên Windows.
Nếu vẫn lỗi, bạn làm theo các bước sau.
- Tìm đường dẫn thật của
phtrong terminal bằngwhich ph(Windows làwhere ph). - Đặt
phillip.pathbằng đường dẫn đầy đủ đó. Hoặc thoát hẳn VS Code rồi mở lại từ terminal bằngcode .để nó kế thừaPATH. - Mở View, Output và chọn kênh Phillip để xem đường dẫn
phđang dùng, lệnh đã chạy và lỗi. - Sau khi đổi cài đặt, chạy Phillip: Refresh.
node vẫn phải tìm được, thường ở /usr/local/bin hoặc thư mục của trình quản lý phiên bản Node. Cách thêm thư mục npm vào PATH có ở Cài đặt chi tiết và Xử lý sự cố.
Hiện extension chưa có panel Ryoma. Muốn xem số liệu, bạn dùng ph ryoma hoặc web.