Làm quen với Project IDX

Hãy đọc tiếp để tìm hiểu những kiến thức cơ bản mà bạn cần để bắt đầu sử dụng Project IDX.

Trước khi bắt đầu

Trước khi bắt đầu, có thể bạn cần bật cookie của bên thứ ba cho trình duyệt của mình. Project IDX yêu cầu cookie của bên thứ ba trong hầu hết các trình duyệt để xác thực không gian làm việc.

Chrome

1. Mở phần Cài đặt.
2. Mở thẻ Quyền riêng tư và bảo mật.
3. Đảm bảo bạn đã bật Cho phép tất cả cookie.
4. Mở idx.google.com.
5. Nhấp vào biểu tượng chế độ hiển thị trong thanh địa chỉ visibility_off để mở bảng điều khiển Chống theo dõi. Bật chế độ cài đặt Cookie của bên thứ ba để tạm thời cho phép cookie của bên thứ ba. Thao tác này sẽ bật cookie trên IDX trong 90 ngày.

Safari

1. Mở Safari > Settings... (Safari > Cài đặt).
2. Tắt các chế độ cài đặt sau:
   • Nâng cao > Chặn tất cả cookie
   • Quyền riêng tư > Ngăn hoạt động theo dõi trên nhiều trang web
3. Mở idx.google.com.

Firefox

Bạn không cần bật cookie của bên thứ ba cho Firefox. Truy cập vào idx.google.com.

Opera

1. Mở idx.google.com.
2. Mở trình đơn rồi nhấp vào Cài đặt.
3. Chuyển đến phần Quyền riêng tư và bảo mật rồi mở rộng tuỳ chọn Cookie của bên thứ ba.
4. Chọn Chặn cookie của bên thứ ba ở Chế độ ẩn danh hoặc Cho phép cookie của bên thứ ba.
5. Mở idx.google.com.

Arc

1. Truy cập vào arc://settings.
2. Chuyển đến phần Quyền riêng tư và bảo mật rồi mở rộng tuỳ chọn Cookie của bên thứ ba.
3. Chọn Chặn cookie của bên thứ ba ở Chế độ ẩn danh hoặc Cho phép cookie của bên thứ ba.
4. Mở idx.google.com.

Brave

Bạn không cần bật cookie của bên thứ ba cho Brave. Truy cập vào idx.google.com.

Tạo một không gian làm việc

Không gian làm việc trong IDX là một môi trường phát triển chứa mọi thứ bạn cần để phát triển ứng dụng. Trong thư viện này chứa mã của bạn, trình soạn thảo mã (có các trình bổ trợ liên quan đến dự án của bạn) và các chuỗi công cụ hỗ trợ phát triển ứng dụng. Việc này tương tự như việc tạo một dự án mới trong môi trường phát triển Máy tính cục bộ, ngoại trừ việc bạn có toàn bộ máy tính và hệ điều hành được định cấu hình sẵn và dành riêng cho việc tạo ứng dụng.

Không gian làm việc của dự án IDX được tối ưu hoá để chứa một cơ sở mã mỗi lần. Nhờ đó, bạn có thể tách biệt các môi trường và phần phụ thuộc cấp hệ thống của các ứng dụng với nhau.

Nếu bạn đang tạo một ứng dụng mới, hãy sử dụng các mẫu không gian làm việc được quản lý trong IDX để bắt đầu nhanh chóng. Ngoài ra, bạn có thể nhập các cơ sở mã ứng dụng hiện có của mình vào IDX.

Lưu ý quan trọng: Chúng tôi có giới hạn về số lượng không gian làm việc mà bạn có thể tạo. Nếu có Hồ sơ nhà phát triển của Google, bạn có thể tạo tối đa 5 không gian làm việc. Để tạo Hồ sơ nhà phát triển của Google ngay từ IDX sau khi bạn đạt đến giới hạn không gian làm việc, hãy nhấp vào Hoàn tất thiết lập trong thông báo trên trang tổng quan của mẫu.

Để tạo không gian làm việc mới, hãy làm theo các bước sau:

• 
• 
• 
• 

1. Mở Project IDX

2. Vào lần đầu tiên mở IDX, bạn sẽ được nhắc đọc và chấp nhận điều khoản dịch vụ cho các sản phẩm của Google, AI tạo sinh và Android SDK. Bạn cũng có thể chọn nhận thông tin cập nhật và thông báo về sản phẩm hoặc nghiên cứu người dùng để cải thiện sản phẩm của chúng tôi. Hãy chọn những lựa chọn phù hợp với bạn. Hãy nhấp vào các đường liên kết được cung cấp để đọc điều khoản dịch vụ, sau đó chọn tuỳ chọn chấp nhận các điều khoản đó rồi nhấp vào Tiếp tục. Tiếp theo, bạn có thể quyết định Bật các tính năng AI trong lần sử dụng IDX đầu tiên hoặc tắt các tính năng này bằng cách nhấp vào Not Now (Không phải ngay bây giờ) (bạn luôn có thể bật các tính năng này sau). Nếu bạn bật các tính năng này trên màn hình này, hãy đọc ghi chú về AI và quyền riêng tư, sau đó nhấp vào Continue (Tiếp tục) để giữ lại chế độ cài đặt của bạn hoặc Back (Quay lại) để tắt các tính năng AI.

3. Chọn loại không gian làm việc bạn muốn tạo:

   • Mẫu: Tạo không gian làm việc được tải sẵn với các tệp và gói cơ bản mà bạn có thể cần. Chọn một trong các mẫu nổi bật hoặc nhấp vào Xem tất cả các mẫu để xem danh sách đầy đủ các khung, API và ngôn ngữ có sẵn. Bạn cũng có thể tìm thấy mẫu Blank Workspace (Không gian làm việc trống) trong thư viện mẫu.
   • Kho lưu trữ GitHub: Chọn Nhập kho lưu trữ để sao chép kho lưu trữ GitHub vào không gian làm việc của bạn.

Mẫu

1. Duyệt qua các mẫu theo loại ứng dụng hoặc sử dụng hộp tìm kiếm ở phía trên bên phải để lọc toàn bộ thư viện mẫu theo từ khoá. Mẫu Không gian làm việc trống có trong danh mục Khác.

2. Nhập tên cho không gian làm việc của bạn và đặt mọi tuỳ chọn bổ sung.

3. Nhấp vào Tạo. IDX tạo một không gian làm việc mới dựa trên các lựa chọn của bạn.

Chúng tôi liên tục bổ sung các mẫu mới, vì vậy, hãy thường xuyên kiểm tra lại hoặc cho chúng tôi biết những nội dung bạn muốn xem.

Nhập từ GitHub

1. Nhập URL Repo.

2. Nhấp vào Tạo. IDX tạo một không gian làm việc mới dựa trên các lựa chọn của bạn.

3. Xác thực với GitHub sau khi không gian làm việc tải.

4. Chạy npm install (hoặc flutter pub get) trong dòng lệnh IDX sau khi nhập dự án. Theo mặc định, IDX không cài đặt các phần phụ thuộc npm khi bạn nhập một dự án.

Định cấu hình không gian làm việc

IDX sử dụng Nix để xác định cấu hình môi trường cho từng không gian làm việc. Nix là một trình quản lý gói có chức năng thuần tuý và gán giá trị nhận dạng duy nhất cho từng phần phụ thuộc, nghĩa là môi trường của bạn có thể chứa một cách liền mạch nhiều phiên bản của cùng một phần phụ thuộc. Mẫu này cũng có tính tái tạo và mang tính khai báo. Trong ngữ cảnh của IDX, điều này có nghĩa là bạn có thể chia sẻ tệp cấu hình Nix của mình trên các không gian làm việc để tải cùng một cấu hình môi trường. Tìm hiểu thêm về Nix + IDX.

Tạo hoặc chỉnh sửa tệp .idx/dev.nix

Cấu hình môi trường được xác định trong tệp .idx/dev.nix trong kho lưu trữ mã. Tệp này cho phép bạn chỉ định các gói đã cài đặt, biến môi trường và tiện ích Code OSS.

Hãy xem tệp .idx/dev.nix mẫu sau đây để biết cấu hình môi trường không gian làm việc cơ bản cho phép xem trước ứng dụng trong IDX:

{ pkgs, ... }: {

  # Which nixpkgs channel to use.
  channel = "stable-23.11"; # or "unstable"

  # Use https://search.nixos.org/packages to find packages
  packages = [
    pkgs.nodejs_18
  ];

  # Sets environment variables in the workspace
  env = {
    SOME_ENV_VAR = "hello";
  };

  # Search for the extensions you want on https://open-vsx.org/ and use "publisher.id"
  idx.extensions = [
    "angular.ng-template"
  ];

  # Enable previews and customize configuration
  idx.previews = {
    enable = true;
    previews = {
      web = {
        command = [
          "npm"
          "run"
          "start"
          "--"
          "--port"
          "$PORT"
          "--host"
          "0.0.0.0"
          "--disable-host-check"
        ];
        manager = "web";
      };
    };
  };
}

Áp dụng cấu hình mới

Mỗi khi bạn thêm hoặc cập nhật tệp cấu hình dev.nix, IDX sẽ hiển thị lời nhắc ở góc dưới cùng bên phải để Tạo lại môi trường. Thời gian cần thiết để xây dựng lại môi trường phụ thuộc vào số lượng gói mà cấu hình của bạn cần.

Lỗi bản dựng trong môi trường gỡ lỗi

Vì các tệp cấu hình là mã mà máy có thể đọc được, nên các tệp này có thể có lỗi. Nếu điều này xảy ra, có thể môi trường sẽ không tạo được và không khởi động được. IDX sẽ hiển thị tuỳ chọn bắt đầu môi trường Recovery. Không gian làm việc này không bao gồm bất kỳ cấu hình nào bạn đã xác định và chỉ chạy mã OSS cơ bản. Điều này giúp bạn có cơ hội sửa lỗi trong tệp cấu hình dev.nix và tạo lại môi trường.

Cuối cùng, IDX sẽ hiển thị các lỗi bản dựng môi trường. Hiện tại, bạn phải tự khắc phục sự cố.

Các bước tiếp theo

• Xem trước ứng dụng.

• Chia sẻ không gian làm việc của bạn.