Bỏ qua, đến phần nội dung

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:

bash
curl -fsSLo phillip-vscode.vsix https://tara.phillipcli.cloud/phillip/phillip-vscode-latest.vsix
code --install-extension phillip-vscode.vsix

Nế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ầnNội dungLệnh ph phía sau
Panel TaraTà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ênph 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ở PRph bandum board --mine; start, verify, test, pr
Status barDạ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ở issuegit 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.0

Nế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 đặtMặc địnhÝ nghĩa
phillip.pathphĐường dẫn tới lệnh ph. Để mặc định thì extension tự tìm
phillip.bandumUrlhttp://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.

  1. Tìm đường dẫn thật của ph trong terminal bằng which ph (Windows là where ph).
  2. Đặt phillip.path bằng đường dẫn đầy đủ đó. Hoặc thoát hẳn VS Code rồi mở lại từ terminal bằng code . để nó kế thừa PATH.
  3. Mở View, Output và chọn kênh Phillip để xem đường dẫn ph đang dùng, lệnh đã chạy và lỗi.
  4. 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.

Đọc thêm ​