安裝或更新 Neat Library
請使用此頁面來安裝或更新 Palette Neat Library。
當您在執行 sima-cli sdk setup 時配對一個 DevKit,SDK 會自動在其 DevKit 上安裝包含的 Neat Library 和捆綁的 PyNeat 環境,並將其安裝在 ~/pyneat 上。
選擇安裝位置
從您建立或執行 Neat 應用程式的環境中執行安裝程式:
| 環境 | 何時使用 |
|---|---|
| Neat SDK | 當您想要在不安裝新的 SDK 版本的情況下,升級 Neat SDK 中的 Neat Library 時。 |
| ROS2 SDK | 當您想要在容器的系統路徑中安裝 Neat 標頭和函式庫後,在 ARM64 上原生編譯 ROS 2 應用程式時。 |
| DevKit | 當您想要直接在裝置上安裝或更新執行階段時。 |
先決條件
在您打算安裝 Neat Library 的環境中安裝 sima-cli。
請參考 sima-cli 安裝指南。
在 community.sima.ai 建立帳戶,即可存取 SiMa.ai 資源,例如用於測試的預先編譯模型。
驗證環境,以便安裝程式可以下載 SiMa.ai 的成品。請參閱 sima-cli 登入 以取得詳細資訊。
sima-cli login確認環境是否能夠連接到 SiMa.ai 成品的主機:
curl -fsS https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh -o /dev/null && echo "artifacts reachable"顯示「artifacts reachable」表示主機可連線。如果出現 curl 錯誤,例如逾時、連線被拒絕,或「無法解析主機」,則表示已封鎖外向連線——請檢查您的主機網路、Proxy 或防火牆(請參閱 Neat SDK 網路功能 和 主機設定注意事項),或者如果機器無法直接連線到 SiMa.ai 服務,請使用 離線安裝。
安裝 Neat Library
安裝程式會使用選取的「核心」成品中列出的所有 Debian 套件, 且不會選擇不同的「內部元件」或 LLiMa 版本。已安裝的平台必須滿足該成品未提供的相依性。如果 APT 會移除平台套件以完成安裝,安裝程式將停止;請更新平台,而不是在「核心」或 LLiMa 中替換套件。
在執行安裝程式之前,請選擇一個工作目錄。在 DevKit 上,將安裝程式安裝在 /media/nvme 目錄下,以避免填滿根檔案系統。在 SDK 容器中,請使用容器內的本地路徑,例如 $HOME/neat。
選擇您的環境,然後依序執行步驟。在 Neat SDK 容器中安裝,以進行跨平台編譯 C++ 應用程式。在 ROS2 SDK 中安裝,以在 ARM64 上進行原生編譯;其 Debian 套件會安裝到 /usr,而不是 Neat 跨平台編譯的系統根目錄。在 DevKit 上安裝,以設定該處的執行階段,同時也會在 ~/pyneat 中設定 PyNeat。安裝程式指令在每個環境中都相同。
準備一個容器本地安裝目錄,例如:$HOME/neat。
cd $HOME && mkdir -p neat && cd neat安裝 sima-cli 預設選取的 Neat Library 套件。您可以選擇性地安裝額外內容,包括預先建置的教學課程、原始碼教學課程和測試:
sima-cli neat install core@v0.4.0預設 PyNeat 環境
在 DevKit 上安裝 Neat Library,同時也會在 DevKit 上的 ~/pyneat 位置建立一個預設的 PyNeat
虛擬環境。這是支援的 PyNeat
環境——請直接啟用它:
source ~/pyneat/bin/activate如果您從與 DevKit Sync 配對的 SDK 容器內部執行安裝程式,則安裝程式不僅會在 SDK 容器內部,還會在配對的 DevKit 上設定 PyNeat。PyNeat 會安裝到 DevKit 上的 ~/pyneat 中的虛擬環境中。
對於自訂的 Python 虛擬環境,請參閱 安裝 PyNeat。
原始碼建置
當您需要使用尚未發布的變更、自訂建置設定,或參與 Neat Library 的開發時,請從原始碼進行建置。大多數使用者應該改用上述的套件安裝方式。
如果您偏好從原始碼開始建置,請遵循「建造」指南。
如需了解 SDK 的設定和 DevKit Sync 的導入流程,請參閱 Neat SDK。
下一步
繼續進行 安裝 PyNeat,以設定自 訂的 Python 環境,或使用 Neat 指令列介面 來檢查已安裝的環境。