全部產品
Search
文件中心

:環境要求與配置

更新時間:Jun 30, 2024

本文介紹了Python Link SDK推薦的開發環境以及開發環境的設定。

環境配置

推薦使用Python 3.6及以上版本。

Python Link SDK在下面的作業系統上進行了驗證,為了避免開發與運行時出錯,請盡量選用與阿里雲一致的軟體環境。

  • Linux:Ubuntu 18.04 64-bit及以上版本。

  • Windows:Windows 7 64-bit及以上版本。

  • macOS:High Sierra。

使用前必讀

  • 本文以Python 3.6版本為例,介紹環境的安裝和配置。如果安裝更高版本,只需將相關命令中python3.6的版本號碼換成對應的高版本號碼。例如:python3.9

  • 本文操作命令以普通使用者權限為例。如果您在操作過程中涉及到管理員權限才能執行的操作,可嘗試使用sudo命令執行。

安裝Python 3.6

Linux和macOS

步驟一:安裝Python3工具

說明

如果已安裝python 3.6或更高版本,請跳過此步驟。

  • Linux

    您可通過命令列或源碼安裝:

    • 命令列安裝:適用於Ubuntu 18.04及以上版本。

      sudo apt-get update
      sudo apt install software-properties-common
      sudo add-apt-repository ppa:deadsnakes/ppa
      sudo apt-get install wget python3.6  
    • 源碼安裝:不支援命令安裝的作業系統推薦使用源碼安裝。

      sudo apt-get install wget gcc make zlib1g-dev 
      wget https://www.python.org/ftp/python/3.6.7/Python-3.6.7.tgz
      tar -xf Python-3.6.7.tgz
      cd Python-3.6.7
      ./configure
      make -j
      sudo make install
  • macOS

    通過此連結進行下載:macOS下載

步驟二:安裝PIP

  1. 擷取PIP指令碼。

    • Python 3.6版本:

       wget https://bootstrap.pypa.io/pip/3.6/get-pip.py
    • Python 3.7及以上版本:

       wget https://bootstrap.pypa.io/get-pip.py
  2. 安裝PIP。

    以安裝Python 3.6的PIP為例,更高版本,只需替換命令中python3.6的版本號碼。例如:python3.9

    sudo apt-get install python3-distutils  
    sudo python3.6 get-pip.py

步驟三:安裝setuptools、wheel和venv

裝置端SDK編譯運行需要安裝包管理工具setuptools、編譯依賴包wheel和venv(Virtual Environment)。

執行以下命令:

python3.6 -m pip install --upgrade pip setuptools wheel
sudo apt-get install python3.6-venv

Windows

根據系統位寬選擇安裝:

下載Demo

通過此連結下載Demo檔案:擷取exmaple範例程式碼

配置環境

說明

建議使用者使用paho-mqtt的1.4.0或1.5.1版本,這兩個版本已經做過壓力測試,可使用pip list命令查看paho-mqtt的版本號碼。

Linux和macOS

  1. 建立和啟用VirtualEnvironments。

  2. mkdir work_dir
    cd work_dir
    python3.6 -m venv test_env
    source test_env/bin/activate
    pip install wheel            
  3. 安裝Link SDK:可選擇自動安裝或者手動安裝。

    自動安裝

    • 執行以下命令安裝paho-mqtt 1.4.0版本。

    • pip install paho-mqtt==1.4.0
    • 執行以下命令安裝Link SDK最新版本。

    • pip install aliyun-iot-linkkit 

    手動安裝

    下載Link SDK以及需要使用到開源的MQTT庫:擷取最新版本的Python Link SDK擷取開源MQTT庫paho

    當前linkkit最新版本為1.2.13。

    將aliyun-iot-linkkit-1.2.13.tar.gz和paho-mqtt-1.4.0.tar.gz放到work_dir目錄下,然後執行以下命令:

    tar zxvf paho-mqtt-1.4.0.tar.gz
    cd paho-mqtt-1.4.0
    python3 setup.py install
    cd ..
    tar zxvf aliyun-iot-linkkit-1.2.13.tar.gz
    cd aliyun-iot-linkkit-1.2.13
    python3 setup.py install
    cd ..
        

Windows

  1. 建立和啟用VirtualEnvironments。

    mkdir work_dir
    cd work_dir
    python3.6 -m venv test_env
    test_env\Scripts\activate.bat            
  2. 安裝Link SDK:可選擇自動安裝或者手動安裝。

    自動安裝

    • 執行以下命令安裝paho-mqtt 1.4.0版本。

      pip install paho-mqtt==1.4.0
    • 執行以下命令安裝Link SDK最新版本。

      pip install aliyun-iot-linkkit      

    手動安裝

    下載Link SDK以及需要使用到開源的MQTT庫:擷取最新版本的Python Link SDK擷取開源MQTT庫paho

    當前linkkit最新版本為1.2.13。

    將paho-mqtt-1.4.0.tar.gz和aliyun-iot-linkkit-1.2.13.tar.gz放到work_dir目錄下並操作解壓,再執行以下命令。

    cd paho-mqtt-1.4.0
    python setup.py install
    cd ..
    cd aliyun-iot-linkkit-1.2.13
    python setup.py install
    cd ..

日誌開關

開啟SDK內部日誌輸出開關。

import logging
__log_format = '%(asctime)s-%(process)d-%(thread)d - %(name)s:%(module)s:%(funcName)s - %(levelname)s - %(message)s'
logging.basicConfig(format=__log_format)

如果需要開啟Debug開關,方法如下:

lk_auth.enable_logger(logging.DEBUG)