安裝AWS IoT Device SDK適用於 Python 的 - AWS IoT Greengrass

AWS IoT Greengrass Version 1 於 2023 年 6 月 30 日進入延長使用壽命階段。如需詳細資訊，請參閱AWS IoT Greengrass V1 維護政策。在此日期之後， AWS IoT Greengrass V1 將不會發行提供功能、增強功能、錯誤修正或安全性修補程式的更新。在上運行的設備 AWS IoT Greengrass V1 不會中斷，並將繼續運行並連接到雲。我們強烈建議您移轉至 AWS IoT Greengrass Version 2，這會增加重要的新功能，並支援其他平台。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

安裝AWS IoT Device SDK適用於 Python 的

用戶端裝置可以使用AWS IoT Device SDK適用於 Python 進行通訊AWS IoT和AWS IoT Greengrass核心裝置 (使用 Python 程式設計語言)。如需詳細資訊 (包括需求)，請參閱AWS IoT Device SDK適用於 Python 的讀我檔案上 GitHub。

在此步驟中，您會安裝軟體開發套件並取得basicDiscovery.py電腦上模擬用戶端裝置所使用的範例功能。

  1. 若要將軟體開發套件與所有需要的元件安裝到您的電腦，請選擇您的作業系統：

    Windows

    1. 請開啟提高命令提示，並執行下列命令：

      python --version

      若沒有傳回任何版本資訊，或是版本號碼小於 2.7 (Python 2) 或小於 3.3 (Python 3)，請遵循 Downloading Python 中的說明來安裝 Python 2.7+ 或 Python 3.3+。如需詳細資訊，請參閱 Using Python on Windows。

    2. 下載AWS IoT Device SDK適用於 Python 的作為zip檔案並將它解壓縮至您電腦上的適當位置。

      記下已解壓縮之 aws-iot-device-sdk-python-master 資料夾的檔案路徑，該資料夾包含 setup.py 檔案。在下一個步驟中，這檔案路徑會以 path-to-SDK-folder 表示。

    3. 自提高命令提示執行下列命令：

      cd path-to-SDK-folder
python setup.py install
    macOS

    1. 請開啟終端機視窗並執行下列命令：

      python --version

      若沒有傳回任何版本資訊，或是版本號碼小於 2.7 (Python 2) 或小於 3.3 (Python 3)，請遵循 Downloading Python 中的說明來安裝 Python 2.7+ 或 Python 3.3+。如需詳細資訊，請參閱 Using Python on a Macintosh。

    2. 在終端機視窗中執行下列命令以判斷 OpenSSL 版本：

      python
>>>import ssl
>>>print ssl.OPENSSL_VERSION

      記下 OpenSSL 的版本值。

      注意

      若您執行的是 Python 3，請使用 print(ssl.OPENSSL_VERSION)。

      若要關閉 Python shell，請執行下列命令：

      >>>exit()

      如果 OpenSSL 版本為 1.0.1 或更新，請跳到步驟 c。否則，請遵循這些步驟：

      1. 請從終端機視窗中執行下列命令來判斷電腦是否使用 Simple Python 版本管理：

        which pyenv

      如果傳回檔案路徑，請選擇使用 pyenv 標籤。如果未傳回，請選擇不使用 pyenv 標籤。

      Using pyenvNot using pyenv
      Using pyenv

      1. 請參閱 Python Releases for Mac OS X (或類似) 以判斷最新又穩定的 Python 版本。在以下範例中，此數值會以 latest-Python-version 表示。

      2. 從終端機視窗中執行下列命令：

        pyenv install latest-Python-version
pyenv global latest-Python-version

        例如，若 Python 2 的最新版本是 2.7.14，則這些命令為：

        pyenv install 2.7.14
pyenv global 2.7.14

      3. 關閉然後重新開啟終端機視窗，執行以下命令：

        python
>>>import ssl
>>>print ssl.OPENSSL_VERSION

        OpenSSL 版本至少應為 1.0.1。若版本小於 1.0.1，則更新會失敗。檢查 pyenv install 和 pyenv global 命令中所使用的 Python 版本值，然後再試一次。

      4. 執行下列命令退出 Python shell：

         exit()
      Not using pyenv

      1. 從終端機視窗執行下列命令來判斷 brew 是否已安裝：

        which brew

        如果沒有傳回檔案的路徑，請安裝如下所示的 brew：

        /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
        注意

        遵循安裝提示。下載 Xcode 命令列工具可能需要一些時間。

      2. 執行下列命令：

        brew update
brew install openssl
brew install python@2

        所以此AWS IoT Device SDK適用於 Python 需要使用 Python 可執行檔編譯的 OpenSSL 版本 1.0.1 (或更新版本)。brew install python 命令會安裝 python2 可執行檔，以符合此需求。python2 可執行檔安裝於 /usr/local/bin 目錄中，應屬於 PATH 環境變數的一部分。若要確認，請執行下列命令：

        python2 --version

        如果已提供 python2 版本資訊，請跳到下一個步驟。若否，請新增 /usr/local/bin 路徑至您的 PATH 環境變數，此需為永久持續，透過將下行附加至您的 shell 描述檔：

        export PATH="/usr/local/bin:$PATH"

        例如，如果您使用的是 .bash_profile 或沒有 shell 設定檔從終端視窗，請執行下列命令：

        echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile

        接著，來源您的 shell 描述檔，並確認 python2 --version 提供版本資訊。例如，如果您是使用 .bash_profile，請執行下列命令：

        source ~/.bash_profile
python2 --version

        應傳回 python2 版本資訊。

      3. 附加下行至您的 shell 描述檔中：

        alias python="python2"

        例如，如果您是使用 .bash_profile 或尚未有 shell 描述檔，則請執行下列命令：

        echo 'alias python="python2"' >> ~/.bash_profile

      4. 接著，來源您的 shell 描述檔。例如，如果您是使用 .bash_profile，請執行下列命令：

        source ~/.bash_profile

        呼叫 python 命令會執行 Python 可執行檔，其中包含所需的 OpenSSL 版本 (python2)。

      5. 執行下列命令：

        python
 import ssl
 print ssl.OPENSSL_VERSION

        OpenSSL 版本至少應為 1.0.1 或更新版。

      6. 若要退出 Python shell，請執行下列命令：

         exit()

    3. 執行下列的命令安裝AWS IoT Device SDK適用於 Python：

      cd ~
git clone https://github.com/aws/aws-iot-device-sdk-python.git
cd aws-iot-device-sdk-python
sudo python setup.py install
    UNIX-like system

    1. 從終端機視窗中，執行下列命令：

      python --version

      若沒有傳回任何版本資訊，或是版本號碼小於 2.7 (Python 2) 或小於 3.3 (Python 3)，請遵循 Downloading Python 中的說明來安裝 Python 2.7+ 或 Python 3.3+。如需詳細資訊，請參閱 Using Python on Unix platforms。

    2. 在終端機中執行下列命令以判斷 OpenSSL 版本：

      python
>>>import ssl
>>>print ssl.OPENSSL_VERSION

      記下 OpenSSL 的版本值。

      注意

      若您執行的是 Python 3，請使用 print(ssl.OPENSSL_VERSION)。

      若要關閉 Python shell，請執行下列命令：

       exit()

      如果 OpenSSL 版本為 1.0.1 或更新，請跳到下一個步驟。否則，請執行命令來更新您發行版本的 OpenSSL (例如 sudo yum update openssl、sudo apt-get update 等)。

      透過執行下列命令確認 OpenSSL 版本為 1.0.1 或更新版：

      python
>>>import ssl
>>>print ssl.OPENSSL_VERSION
>>>exit()

    3. 執行下列的命令安裝AWS IoT Device SDK適用於 Python：

      cd ~
git clone https://github.com/aws/aws-iot-device-sdk-python.git
cd aws-iot-device-sdk-python
sudo python setup.py install

  2. 之後AWS IoT Device SDK適用於 Python 已安裝，請導覽至samples文件夾並打開greengrassfolder。

    在本教學課程中，您將複製 basicDiscovery.py 範例函數，該函數會使用您在 在中建立用戶端裝置AWS IoT Greengrass群組 中下載的憑證和金鑰。

  3. 複製basicDiscovery.py至包含的資料夾 HelloWorld_ 發行者和 HelloWorld_ 訂閱者裝置憑證和金鑰。