pure::variants – Trình kết nối cho
Sổ tay quản lý mã nguồn
Công ty TNHH Công nghệ Parametric
Phiên bản 6.0.7.685 dành cho pure::variants 6.0
Bản quyền © 2003-2024 Parametric Technology GmbH
2024
Giới thiệu
pure::variants Connector for Source Code Management (Connector) cho phép các nhà phát triển quản lý tính biến thiên của mã nguồn bằng pure::variants. Source Code Management của pure::variants cung cấp một cơ hội linh hoạt để đồng bộ hóa các cấu trúc thư mục và mã nguồn files dễ dàng với các mô hình pure::variants. Do đó, quản lý các biến thể có thể được áp dụng thực tế ngay cả đối với các dự án phần mềm phức tạp. Hơn nữa, các kết nối giữa các tính năng pure::variants và mã nguồn có thể được quản lý dễ dàng hơn với trình xây dựng và có thể truy cập cao thông qua Quản lý mã nguồn.
1.1. Yêu cầu phần mềm
Trình kết nối pure::variants dành cho Quản lý mã nguồn là tiện ích mở rộng cho pure::variants và có sẵn trên tất cả các nền tảng được hỗ trợ.
1.2. Cài đặt
Vui lòng tham khảo phần pure::variants Trình kết nối trong Hướng dẫn cài đặt pure::variants để biết thông tin chi tiết về cách cài đặt trình kết nối (menu Trợ giúp -> Nội dung trợ giúp và sau đó là hướng dẫn cài đặt pure::variants -> pure::variants Connectors).
1.3. Về hướng dẫn này
Người đọc được kỳ vọng có kiến thức cơ bản và kinh nghiệm về pure::variants. Vui lòng tham khảo tài liệu giới thiệu trước khi đọc hướng dẫn này. Hướng dẫn có sẵn trong trợ giúp trực tuyến cũng như ở định dạng PDF có thể in tại đây.
Sử dụng Trình kết nối
2.1. Bắt đầu pure::variants
Tùy thuộc vào phương pháp cài đặt được sử dụng, hãy khởi động Eclipse hỗ trợ pure::variants hoặc trên Windows, hãy chọn mục pure::variants từ menu chương trình.
Nếu góc nhìn Quản lý biến thể chưa được kích hoạt, hãy thực hiện bằng cách chọn góc nhìn đó từ Mở góc nhìn->Khác… trong menu Cửa sổ.
2.2. Nhập Cây Thư mục vào Mô hình Gia đình
Trước khi nhập cây thư mục vào Family Model, phải tạo một dự án variables. Ngoài ra, nên có các tính năng được xác định trong Feature Model. Vui lòng tham khảo tài liệu pure::variants để được trợ giúp về các bước này.
Quá trình nhập thực tế được bắt đầu bằng cách chọn hành động Nhập… trong menu ngữ cảnh của Dự án view hoặc với menu Nhập… trong File menu. Chọn Variant Models hoặc Projects từ danh mục Variant Management và nhấn Next. Trên trang tiếp theo, chọn Import a Family Model from source folder và nhấn Next lần nữa.
Chọn loại mã nguồn để nhập
Trình hướng dẫn nhập xuất hiện (xem Hình 1, “Trang của trình hướng dẫn nhập để chọn loại mã nguồn có thể được nhập”). Chọn một loại dự án để nhập và nhấn Tiếp theo. Mỗi loại chứa một tập hợp được xác định trước file các kiểu để nhập vào mô hình.
Hình 1. Trang của trình hướng dẫn nhập để chọn loại mã nguồn có thể được nhập
Chọn Nguồn và Mục tiêu
Trên trang trình hướng dẫn tiếp theo (Hình 2, “Trang của trình hướng dẫn nhập để chọn nguồn và đích nhập”) thư mục nguồn và mô hình đích phải được chỉ định.
Nhấn nút Browse… để chọn thư mục chứa mã nguồn cần nhập. Theo mặc định, không gian làm việc hiện tại được chọn vì đây có thể là điểm hữu ích để bắt đầu điều hướng.
Bên dưới, bạn có thể chỉ định mẫu include và exclude. Các mẫu này phải là biểu thức chính quy java. Mỗi đường dẫn đầu vào, liên quan đến thư mục gốc nguồn, được kiểm tra bằng mẫu này. Nếu mẫu include khớp, một thư mục sẽ được nhập, nếu mẫu exclude không khớp. Nghĩa là mẫu include sẽ chọn trước các thư mục để nhập, mẫu exclude sẽ hạn chế lựa chọn trước này.
Sau khi chọn thư mục mã nguồn, phải xác định mô hình mục tiêu. Do đó, hãy chọn một dự án biến thể hoặc một thư mục nơi mô hình sẽ được lưu trữ và nhập tên mô hình. file tên được tự động mở rộng với phần mở rộng .ccfm nếu nó không được cung cấp trong hộp thoại này. Theo mặc định, nó sẽ được đặt thành cùng tên với tên mô hình. Đây là cài đặt được khuyến nghị.
Sau khi thư mục nguồn thuận tiện và tên mô hình mong muốn được chỉ định, hộp thoại có thể được hoàn tất bằng cách nhấn Finish. Nếu nhấn nút Next, một trang khác sẽ xuất hiện, tại đó có thể thực hiện các thiết lập bổ sung.
Hình 2. Trang của trình hướng dẫn nhập để chọn nguồn và đích cho việc nhập
Thay đổi tùy chọn nhập
Trên trang trình hướng dẫn cuối cùng (Hình 3, “Trang của trình hướng dẫn nhập để xác định cấu hình riêng lẻ”) có những tùy chọn có thể được thực hiện để tùy chỉnh hành vi nhập cho dự án phần mềm được nhập.
Trang hộp thoại hiển thị một bảng trong đó file các kiểu được xác định sẽ được xem xét trong quá trình nhập.
Mỗi dòng gồm có bốn trường.
- Trường Mô tả chứa một văn bản mô tả ngắn để xác định file kiểu.
- Các File trường mẫu tên được sử dụng để chọn files được nhập khi chúng khớp với giá trị của trường. Trường sử dụng cú pháp sau:
- Trường hợp sử dụng phổ biến nhất có thể là file phần mở rộng. Cú pháp thông thường là .EXT, trong đó EXT là phần mở rộng mong muốn file phần mở rộng (ví dụ .java).
- Một tình huống phổ biến khác là một tình huống đặc biệt file, giống như một làmfile. Do đó, có thể khớp chính xác file tên. Để làm điều này, chỉ cần nhập file nhập tên vào trường (ví dụ build.xml).
- Trong một số trường hợp, mong muốn lập bản đồ cụ thể hơn, vì vậy chỉ files phù hợp với một mẫu đặc biệt nên được nhập. Để phù hợp với yêu cầu này, có thể sử dụng các biểu thức chính quy trong File trường mẫu tên.
Việc mô tả cú pháp của biểu thức chính quy sẽ vượt quá mục đích của trợ giúp này. Vui lòng tham khảo phần biểu thức chính quy của chương tham khảo trong hướng dẫn sử dụng pure::variants (ví dụ: .*).
- Trường loại phần tử được ánh xạ thiết lập ánh xạ giữa một file loại và một loại phần tử họ pure::variants. Loại phần tử họ là một mô tả cho nguồn file để cung cấp thêm thông tin cho phần tử được ánh xạ trong mô hình đã nhập. Các lựa chọn điển hình là ps:class hoặc ps:makefile.
- Bản đồ đã được lập file trường loại thiết lập ánh xạ giữa một file loại và một pure::variants file loại. Các file nhập trong pure::variants là một mô tả cho nguồn file để cung cấp thêm thông tin cho phần tử được ánh xạ trong mô hình đã nhập. Các lựa chọn điển hình là impl để triển khai hoặc def để định nghĩa files.
Hình 3. Trang của trình hướng dẫn nhập để xác định cấu hình riêng lẻ
Mới file có thể thêm các loại bằng cách sử dụng nút Thêm ánh xạ. Tất cả các trường được điền bằng giá trị undefined và phải được người dùng điền vào. Để chỉnh sửa giá trị trong một trường, chỉ cần nhấp vào trường bằng chuột. Giá trị trở nên có thể chỉnh sửa và có thể thay đổi. Không thể thay đổi giá trị mặc định file tên mẫu của bảng. Để tùy chỉnh linh hoạt, có thể bỏ chọn một file nhập bằng cách bỏ chọn hàng. Bỏ chọn file các mẫu tên vẫn nằm trong cấu hình nhưng sẽ không được trình nhập sử dụng. Người dùng xác định file có thể xóa các kiểu một lần nữa bằng cách sử dụng nút Xóa ánh xạ.
Theo mặc định, một cái khác files file mẫu tên có sẵn trong bảng nhưng không được chọn. Thông thường không muốn nhập tất cả filenhưng điều này có thể dễ dàng thay đổi bằng cách chọn hàng tương ứng.
Có ba tùy chọn nhập chung để tùy chỉnh hành vi của trình nhập.
- Không nhập các thư mục mà không khớp files (ví dụ: thư mục CVS).
Nếu người nhập khẩu tìm thấy một thư mục không khớp file nằm trong đó và không có thư mục con nào có thư mục con phù hợp file, thư mục sẽ không được nhập. Điều này thường hữu ích nếu các dự án được quản lý bởi các hệ thống quản lý phiên bản như CVS. Đối với CVS, mỗi thư mục có liên quan đều chứa một thư mục CVS khi không liên quan files được lưu trữ. Nếu tùy chọn này được chọn và CVS-files không khớp với bất kỳ file kiểu được định nghĩa ở trên, thư mục sẽ không được nhập dưới dạng thành phần vào Family Model. - Loại files và các thư mục.
Bật tùy chọn này để sắp xếp filevà các thư mục được sắp xếp theo thứ tự bảng chữ cái. - Xử lý đường dẫn nhập khẩu.
Để đồng bộ hóa thêm, trình nhập cần lưu trữ đường dẫn gốc của tất cả các phần tử được nhập vào mô hình.
Trong nhiều trường hợp, Family Models được chia sẻ với những người dùng khác. Cấu trúc thư mục có thể khác nhau đối với mỗi người dùng. Để hỗ trợ hầu hết các tình huống sử dụng phổ biến, trình nhập có thể hoạt động ở nhiều chế độ khác nhau:
| Tuyệt đối | Đường dẫn tuyệt đối đến phần tử được nhập sẽ được lưu trữ vào mô hình. Để đồng bộ hóa sau này và trong quá trình chuyển đổi filephải được đặt ở đúng vị trí như trong lần nhập đầu tiên. |
| Liên quan đến Không gian làm việc | Các đường dẫn được lưu trữ liên quan đến thư mục không gian làm việc. Để đồng bộ hóa files phải là một phần của không gian làm việc Eclipse. Chuyển đổi phải sử dụng không gian làm việc Eclipse làm thư mục đầu vào. |
| Liên quan đến Dự án | Các đường dẫn được lưu trữ liên quan đến dự án. Để đồng bộ hóa files là một phần của dự án bên trong Eclipse. Quá trình chuyển đổi phải sử dụng thư mục dự án làm thư mục đầu vào. |
| Tương đối với Đường dẫn | Các đường dẫn được lưu trữ tương đối với đường dẫn đã cho. Để đồng bộ hóa files phải được đặt ở cùng một vị trí chính xác. Thư mục đầu vào chuyển đổi giống với đường dẫn tương đối trong quá trình nhập. |
Tất cả các tùy chọn của hộp thoại này được lưu trữ liên tục. Các tùy chỉnh cá nhân không được thực hiện lại mỗi lần chạy nhập. Điều này giúp quy trình nhập dễ dàng và nhanh chóng.
2.3. Cập nhật mô hình từ cây thư mục
Nhấn nút Đồng bộ hóa 
để đồng bộ hóa một mô hình đã nhập với đường dẫn thư mục của nó. Đường dẫn gốc của dự án được lưu trữ trong mô hình để nó sẽ đồng bộ hóa với cùng một thư mục như trước. Để bật nút Đồng bộ hóa, hãy mở mô hình và chọn bất kỳ phần tử nào. Sau khi nhấn nút Đồng bộ hóa, Trình chỉnh sửa so sánh sẽ mở ra, trong đó Mô hình họ hiện tại và mô hình của cấu trúc thư mục hiện tại đối lập nhau (xem Hình 4, “Cập nhật mô hình từ Cây thư mục trong Trình chỉnh sửa so sánh”).
Hình 4. Cập nhật mô hình từ Cây thư mục trong Trình chỉnh sửa so sánh 
Trình chỉnh sửa so sánh được sử dụng trong toàn bộ pure::variants để so sánh các phiên bản mô hình nhưng trong trường hợp này được sử dụng để so sánh cấu trúc thư mục vật lý (hiển thị ở phía dưới bên phải) với mô hình pure::variants hiện tại (phía dưới bên trái). Tất cả các thay đổi được liệt kê dưới dạng các mục riêng biệt ở phần trên của trình chỉnh sửa, được sắp xếp theo các thành phần bị ảnh hưởng.
Việc chọn một mục trong danh sách này sẽ làm nổi bật sự thay đổi tương ứng trong cả hai mô hình. Trong ví dụample, một phần tử được thêm vào được đánh dấu bằng một hộp ở phía bên phải và được kết nối với vị trí khả thi của nó trong mô hình ở phía bên trái. Thanh công cụ Merge giữa cửa sổ trình soạn thảo trên và dưới cung cấp các công cụ để sao chép một hoặc thậm chí tất cả các thay đổi (không xung đột) dưới dạng toàn bộ từ mô hình cây thư mục sang Mô hình tính năng.
Ghi chú
Việc đồng bộ hóa được thực hiện với các thiết lập nhập khẩu được sử dụng gần đây nhất. Điều này giúp có thể cập nhật mô hình với các thiết lập khác được thực hiện trong khi quá trình nhập khẩu được thực hiện.
Sử dụng chỉ mục quan hệ
Bộ kết nối cho Quản lý mã nguồn tăng cường mối quan hệ View với thông tin về các kết nối giữa các phần tử mô hình pure::variants và mã nguồn. Các mối quan hệ được thêm vào cho các tính năng được sử dụng trong các điều kiện của các phần tử ps:condxml và ps:condtext.
Đối với ps:flag và ps:flagfile các thành phần vị trí của các hằng số tiền xử lý trong nguồn C/C++ files được hiển thị. Ngoài ra, vị trí của các hằng số tiền xử lý phù hợp được hiển thị cho một tính năng được chọn bằng cách sử dụng ánh xạ giữa các tên duy nhất của tính năng và các hằng số tiền xử lý.
3.1. Thêm Relation Indexer vào một Project
Có thể kích hoạt chỉ mục quan hệ trên trang thuộc tính dự án đặc biệt. Chọn dự án và chọn mục Thuộc tính trong menu ngữ cảnh. Trong hộp thoại sắp tới, hãy chọn trang Chỉ mục quan hệ.
Hình 5. Trang thuộc tính dự án cho Trình lập chỉ mục quan hệ
Bộ lập chỉ mục quan hệ được kích hoạt cho dự án bằng cách chọn tùy chọn Bật bộ lập chỉ mục quan hệ (1). Sau khi bật bộ lập chỉ mục, có một số tùy chọn khác để xác định hành vi cụ thể của dự án. Việc lập chỉ mục của Điều kiện pure::variants và Hằng số tiền xử lý C/C++ có thể được kích hoạt riêng biệt (2). Danh sách với file mẫu tên (3) được sử dụng để chọn files để lập chỉ mục. Chỉ files khớp với một trong các mẫu được quét. Thêm “*” làm mẫu để quét tất cả filecủa một dự án.
Sau khi kích hoạt trình lập chỉ mục cho một dự án, một trình xây dựng được thêm vào dự án. Trình xây dựng này quét các thay đổi files cho các mối quan hệ mới với các phần tử mô hình pure::variants một cách tự động.
3.2. Mối quan hệ với Mã nguồn
Với chỉ mục quan hệ được kích hoạt, Quan hệ View chứa các mục nhập bổ sung. Các mục nhập này hiển thị tên của file và số dòng của điểm biến thể. Mẹo công cụ hiển thị phần thích hợp của file. Bằng cách nhấp đúp vào mục nhập file sẽ được mở trong trình soạn thảo.
pure::variants Điều kiện
Điều kiện pure::variants có thể được sử dụng để bao gồm hoặc loại trừ các phần của file tùy thuộc vào lựa chọn tính năng. Condition Indexer quét các quy tắc như vậy và trích xuất các tính năng được tham chiếu. Nếu tính năng như vậy được chọn trong trình soạn thảo, Relations View sẽ hiển thị tất cả files và các dòng nơi có điều kiện với tính năng được chọn (xem Hình 6, “Biểu diễn của Điều kiện trong Quan hệ View”).
Hình 6. Biểu diễn một điều kiện trong các mối quan hệ View
Để có lời giải thích chi tiết về cách xác định điều kiện, hãy tham khảo phần ps:condtext của chương 9.5.7 trong Hướng dẫn sử dụng pure::variants (Tham khảo–>Kiểu phần tử nguồn được xác định trước–>ps:condtext).
Hằng số tiền xử lý C/C++
Bộ lập chỉ mục tiền xử lý C/C++ quét files cho các hằng số được sử dụng trong các quy tắc tiền xử lý (ví dụ #ifdef, #ifndef, …).
Nếu ps:flag hoặc ps:flagfile phần tử được chọn là Quan hệ View hiển thị cách sử dụng hằng số tiền xử lý đã xác định.
Các mối quan hệ View cũng hiển thị các hằng số tiền xử lý được kết nối với các tính năng bằng cách sử dụng các mẫu ánh xạ. Đối với điều này, các mẫu được mở rộng với dữ liệu của tính năng được chọn. Các ký hiệu kết quả được sử dụng để tìm kiếm các hằng số tiền xử lý phù hợp. Hình 7, “Biểu diễn hằng số tiền xử lý C/C++ trong quan hệ View” cho thấy một example với mẫu fame{Name}. Mẫu được mở rộng với tên duy nhất của tính năng thành fameNative. Trong mã được lập chỉ mục, có 76 vị trí mà hằng số tiền xử lý fameNative được sử dụng.
Các vị trí này được hiển thị trong mục Quan hệ View. Các mẫu có thể được xác định trong tùy chọn (xem Phần 3.3, “Tùy chọn”).
Hình 7. Biểu diễn hằng số tiền xử lý C/C++ trong quan hệ View
3.3. Các sở thích
Để thay đổi hành vi mặc định của trình lập chỉ mục, hãy mở tùy chọn Eclipse và chọn trang Relation Indexer trong danh mục Variant Management. Trang này hiển thị hai danh sách.
Hình 8. Trang tùy chọn của trình lập chỉ mục quan hệ
Danh sách trên cùng chứa mặc định file mẫu cho người lập chỉ mục (1). Danh sách này là thiết lập mẫu ban đầu cho các dự án mới được kích hoạt.
Danh sách bên dưới chứa bản đồ giữa các tính năng và hằng số tiền xử lý (2). Bản đồ này được sử dụng cho tất cả các dự án. Bảng 1, “Các bản đồ thay thế được hỗ trợ” hiển thị tất cả các bản đồ thay thế có thể.
Bảng 1. Thay thế ánh xạ được hỗ trợ
| Ký tự đại diện | Sự miêu tả | Example: Tính năngA |
| Tên | Tên duy nhất của tính năng được chọn | FLAG_{Tên} – FLAG_FeatureA |
| TÊN | chữ hoa Tên duy nhất của tính năng được chọn | FLAG_{NAME} – FLAG_FEATUREA |
| tên | chữ thường Tên duy nhất của tính năng được chọn | flag_{tên} – flag_featurea |
Tài liệu / Tài nguyên
 |
pure-systems 2024 Connector cho phần mềm quản lý mã nguồn [tập tin pdf] Hướng dẫn sử dụng 2024, 2024 Connector cho phần mềm quản lý mã nguồn, Connector cho phần mềm quản lý mã nguồn, Phần mềm quản lý mã nguồn, Phần mềm quản lý, Phần mềm |
