建立原始碼發行版

可以執行以下命令為專案建立原始碼發行版：

$ python -m build --sdist .

在專案根目錄中。這會在專案根目錄的 dist 資料夾中建立一個 .tar.gz 壓縮檔。此壓縮檔包含版本控制中最新提交的所有內容，並移除所有版本控制的中繼資料。未提交的修改和版本控制系統未知的檔案將不包含在內。

原始碼發行版壓縮檔是透過將必要的元資料檔案加入執行 meson dist --no-tests --allow-dirty 命令取得的壓縮檔來建立的。若要產生原始碼發行版，meson-python 必須透過執行 meson setup 命令成功設定 Meson 專案。可以將其他參數傳遞給 meson dist 以變更其行為。請參閱相關的 Meson 文件 以及 傳遞參數給 Meson 指南以取得詳細資訊。

meson dist 命令使用底層版本控制系統的封存工具來建立壓縮檔。這表示原始碼發行版只能為在版本控制系統中進行版本控制的專案建立。Meson 支援 Git 和 Mercurial 版本控制系統。

可以透過版本控制系統提供的相關機制將檔案從原始碼發行版中排除。當使用 Git 作為版本控制系統時，可以透過設定 export-ignore 屬性將檔案從原始碼發行版中排除。例如，新增一個包含以下內容的 .gitattributes 檔案：

dev/** export-ignore

將導致 dev 資料夾從原始碼發行版中排除。請參閱 git archive 文件以取得詳細資訊。另一個變更原始碼發行版內容的機制是由 dist 腳本提供。請參閱相關的 Meson 文件以取得詳細資訊。