Deprecated features are features that iotagent-node-lib stills support but that are not maintained or evolved any longer. In particular:
- Bugs or issues related with deprecated features and not affecting any other feature are not addressed (they are closed in github.com as soon as they are spotted).
- Documentation on deprecated features is removed from the repository documentation. Documentation is still available in the documentation set associated to older versions (in the repository release branches).
- Deprecated functionality is eventually removed from iotagent-node-lib. Thus you are strongly encouraged to change your implementations using iotagent-node-lib in order not rely on deprecated functionality.
A list of deprecated features and the version in which they were deprecated follows:
- Support to NGSI v1 (finally removed in 2.18.0)
- Support to Node.js v4 in iotagent-node-lib 2.8.1 (finally removed in 2.9.0)
- Support to Node.js v6 in iotagent-node-lib 2.9.0 (finally removed in 2.10.0)
- Support to Node.js v8 in iotagent-node-lib 2.12.0 (finally removed in 2.13.0)
- Support to Node.js v10 in iotagent-node-lib 2.15.0 (finally removed in 2.16.0)
- Support to Node.js v12 in iotagent-node-lib 2.24.0 (finally removed in 2.25.0)
- Support to NGSI-LD v1.3 in iotagent-node-lib 2.25.0 (finally removed in 2.26.0)
- Support groups (provision) statically defined by configuration
- Support to in-memory registry (i.e.
deviceRegistry.type=memory
) - eventType configuration (finally removed in 3.0.0)
- Support to legacy expressions (finally removed in 3.2.0)
- Bidirectinal pluging (finally removed in 3.4.0)
- appendMode configuration (
IOTA_APPEND_MODE
env var) (finally removed in 3.4.0)
The use of Node.js v14 is highly recommended.
Although you are encouraged to use always the newest iotagent-node-lib version, take into account the following information in the case you want to use old versions:
- Code corresponding to old releases is available at the
iotagent-node-lib GitHub repository. Each release number (e.g.
2.7.0 ) has associated the following: _ A tag, e.g.
2.7.0
. It points to the base version. _ A release branch,release/2.7.0
. The HEAD of this branch usually matches the aforementioned tag. However, if some hotfixes were developed on the base version, this branch contains such hotfixes. - Documentation corresponding to old versions can be found at readthedocs.io. Use the panel in the right bottom corner to navigate to the right version.
The following table provides information about the last iotagent-node-lib version supporting currently removed features:
Removed feature | Last iotagent-node-lib version supporting feature | That version release date |
---|---|---|
NGSI v1 API | 2.17.0 | August 30th, 2021 |
Support to Node.js v4 | 2.8.1 | December 19th, 2018 |
Support to Node.js v6 | 2.9.0 | May 22nd, 2019 |
Support to Node.js v8 | 2.12.0 | April 7th, 2020 |
Support to Node.js v10 | 2.15.0 | February 18th, 2021 |
Support to Node.js v12 | 2.24.0 | September 2nd, 2022 |
Support to NGSI-LD 1.3 | 2.25.0 | January 24th, 2023 |
eventType configuration | 2.26.0 | March 15th, 2023 |
Support to Legacy Expressions | 3.1.0 | April 25th, 2023 |
bidirectional plugin | 3.3.0 | August 24th, 2023 |
appendMode configuration (IOTA_APPEND_MODE env var) |
3.3.0 | August 24th, 2023 |