Cette rubrique décrit les environnements de développement recommandés pour Link SDK for Python et explique comment les configurer.
Configuration de l'environnement
Nous vous recommandons d'utiliser Python 3.6 ou une version ultérieure.
Link SDK for Python a été validé sur les systèmes d'exploitation suivants. Pour éviter les erreurs lors du développement et de l'exécution, nous vous conseillons d'utiliser l'un des environnements ci-dessous :
Linux : Ubuntu 18.04 64 bits ou version ultérieure
Windows : Windows 7 64 bits ou version ultérieure
macOS : High Sierra
Remarques
Cet exemple illustre l'installation et la configuration des environnements en utilisant Python 3.6. Si vous souhaitez installer une version supérieure à Python 3.6, remplacez le numéro de version dans la commande
python3.6par celui de la version cible. Par exemple :python3.9.Cet exemple utilise un utilisateur standard. Si certaines opérations nécessitent des droits d'administrateur, exécutez la commande
sudo.
Installer Python 3.6
Linux et macOS
Étape 1 : Installer Python 3.6
Si Python 3.6 ou une version ultérieure est déjà installé, ignorez cette étape.
-
Linux
Pour installer Python 3.6, utilisez l'une des méthodes suivantes :
-
Commandes : Cette méthode convient aux systèmes Ubuntu 18.04 ou ultérieurs.
sudo apt-get update sudo apt install software-properties-common sudo add-apt-repository ppa:deadsnakes/ppa sudo apt-get install wget python3.6 -
Code source : Cette méthode s'applique aux systèmes d'exploitation qui ne prennent pas en charge l'installation via des commandes.
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
Téléchargez Python depuis Python for macOS.
Étape 2 : Installer pip
-
Récupérez le script pip.
-
Python 3.6 :
wget https://bootstrap.pypa.io/pip/3.6/get-pip.py -
Python 3.7 ou version ultérieure
wget https://bootstrap.pypa.io/get-pip.py
-
-
Installez pip.
Dans cet exemple, nous installons pip pour Python 3.6. Pour installer une version plus récente de pip, remplacez le numéro de version dans la commande
python3.6par celle souhaitée. Par exemple :python3.9.sudo apt-get install python3-distutils sudo python3.6 get-pip.py
Étape 3 : Installer setuptools, wheel et venv
Pour compiler et exécuter Link SDK for Python, vous devez installer setuptools, wheel et venv. Setuptools sert à gérer les packages Python, tandis que wheel et venv sont nécessaires à la compilation du SDK. Venv permet de gérer les environnements virtuels.
Exécutez la commande suivante :
python3.6 -m pip install --upgrade pip setuptools wheel
sudo apt-get install python3.6-venv
Windows
Téléchargez et installez l'un des packages suivants selon le type de votre système d'exploitation :
Télécharger la démo
Téléchargez la démo depuis Obtenir l'exemple de code.
Configurer les environnements
Alibaba Cloud a effectué des tests de charge sur paho-mqtt v1.4.0 et paho-mqtt v1.5.1. Nous vous recommandons d'utiliser l'une de ces versions. Vous pouvez exécuter la commande pip list pour consulter la version de votre paho-mqtt.
Linux et macOS
Créez et activez un environnement virtuel
-
Installez Link SDK for Python automatiquement ou manuellement.
Installation automatique du SDK Go
Exécutez la commande suivante pour installer paho-mqtt v1.4.0 :
Exécutez la commande suivante pour installer la dernière version de Link SDK for Python :
pip install paho-mqtt==1.4.0pip install aliyun-iot-linkkitInstallation manuelle du logiciel
Téléchargez le SDK depuis Obtenir la dernière version de Link SDK for Python ainsi que les bibliothèques MQTT open source requises depuis Obtenir les bibliothèques Paho MQTT open source.
La dernière version de Link SDK for Python est la 1.2.12.
Copiez les packages aliyun-iot-linkkit-1.2.12.tar.gz et paho-mqtt-1.4.0.tar.gz dans le répertoire work_dir, puis exécutez les commandes suivantes :
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.12.tar.gz cd aliyun-iot-linkkit-1.2.12 python3 setup.py install cd ..
mkdir work_dir
cd work_dir
python3.6 -m venv test_env
source test_env/bin/activate
pip install wheel
Windows
-
Créez et activez un environnement virtuel
mkdir work_dir cd work_dir python3.6 -m venv test_env test_env\Scripts\activate.bat -
Installez Link SDK for Python automatiquement ou manuellement.
Installation automatique du SDK Go
-
Exécutez la commande suivante pour installer paho-mqtt v1.4.0 :
pip install paho-mqtt==1.4.0 -
Exécutez la commande suivante pour installer la dernière version de Link SDK for Python :
pip install aliyun-iot-linkkit
Installation manuelle du logiciel
Téléchargez le SDK depuis Obtenir la dernière version de Link SDK for Python ainsi que les bibliothèques MQTT open source requises depuis Obtenir les bibliothèques Paho MQTT open source.
La dernière version de Link SDK for Python est la 1.2.12.
Copiez les packages paho-mqtt-1.4.0.tar.gz et aliyun-iot-linkkit-1.2.12.tar.gz dans le répertoire work_dir, décompressez-les, puis exécutez les commandes suivantes :
cd paho-mqtt-1.4.0 python setup.py install cd .. cd aliyun-iot-linkkit-1.2.12 python setup.py install cd .. -
Activation des journaux
Activez la sortie des journaux internes du 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)