axiscommunications / acap-documentation Goto Github PK
View Code? Open in Web Editor NEWDocumentation of the ACAP version 4 SDK
Home Page: https://axiscommunications.github.io/acap-documentation/
License: Other
Documentation of the ACAP version 4 SDK
Home Page: https://axiscommunications.github.io/acap-documentation/
License: Other
I cannot find markdownlint being run for the markdown files in the GitHub pipeline, am I missing something or is it indeed missing?
The files schema-field-descriptions-*
are auto-generated from an upstream source. As a contributor this is not obvious.
Action points:
In Azure there's a concept called ARM which basically are JSON files that describe infrastructure. Here you can see how they are documented.
In AWS there's a concept called CloudFormation which, again, basically are JSON files that describe infrastructure. Here you can see how they are documented.
One cannot help but to identify the similarities. They both start with a JSON document that highlight the structure, and then below the document each property is described, together with its type and whether it is required.
As the saying goes: good artists borrow, great artists steal.
Hi,
Why are we referring to 2 different versions tracks in our official ACAP Native SDK documentation, i.e. version 1.x track and version 4.x track?
This just causes confusion, why not only refer to 4.x versions in all places?
See this page:
https://axiscommunications.github.io/acap-documentation/docs/api/native-sdk-api.html#compatibility
The table below shows ACAP Native SDK and firmware version compatibility.
SDK version | Available from firmware version |
---|---|
1.0 | 10.7 |
1.1 | 10.9 |
1.2 | 10.10 |
1.3 | 10.12 |
1.4 | 11.0 |
1.5 | 11.1 |
1.6 | 11.2 |
1.7 | 11.3 |
....and compare it to this one:
Choose the appropriate SDK version based on what AXIS OS version you want supporting your ACAP.
ACAP SDK version | Compatible with AXIS OS version |
---|---|
SDK 4.0 | 10.7 and later |
SDK 4.1 | 10.9 and later |
SDK 4.2 | 10.10 and later |
SDK 4.3 | 10.12 and later |
SDK 4.4 | 11.0 and later |
SDK 4.5 | 11.1 and later |
SDK 4.6 | 11.2 and later |
SDK 4.7 | 11.3 and later |
Is there any particular benefit of mentioning 1.x versions at all?
The following idea came after reading Manifest schemas.
Many text editors and IDE:s today have either built in, or can be extended with, support for validating JSON files against a JSON schema. Validating the manifest, given its version, before running the actual build would improve the feedback loop, which is nice.
I would be open to contribute the JSON schemas, given that we decide where they should be published. One alternative would be to publish them on JSON Schema Store, another would be to self-host it them one of our repositories. Each alternative has pros and cons.
On Application project structure - Create a manifest file from scratch in bullet 2 we describe the running mode as the application keeps running at a reboot, but looking at the code sample we use the value never
which according to the manifest description means that the application will never be restarted.
This doesn't add up. One of the descriptions is wrong.
Do the runtime credentials also give us access to the RTSP server? Have not yet tested this, if not then please add this. Otherwise we still need to ask clients to enter a username/password upon app installation on the camera. This is an inconvenience which lowers adoption and long term stability of the app. Our app uses the local RTSP server and for the sake of efficiency we do not want to duplicate this functionality inside our app.
Thank you.
On Set up device - Find the device on the network we propose tools that only work on Windows. These tools are really good at what they do, but I think there's room for an officially supported cross platform device discovery tool that we can use on Linux and macOS.
Preferably it would be a discovery tool that adhere to the Linux principles, letting you pipe results and stuff like that, making it easy to integrate the tool into any pipeline you build.
And taking a stand here, it would be much better if this tool was written in Go, published as open source, and maintained in this Axis organization.
In the table describing the manifest file content, there's a reference attached to the parameter called acapPackageConf.setup.embeddedSdkVersion
. The reference is assumed to be found under the table, but is instead found at the end of the document, under a chapter called Local data.
We have gotten the feedback that we ought to state in the documentation that applications built using older SDKs cannot be signed in the ACAP portal. This is relevant for ACAP3 SDK versions below 3.5 and Native SDK versions below 1.1.
The reason for this is that the portal requires "architecture" to be included in the manifest, and support for that did not exist in earlier SDKs.
When reading Create a manifest file from scratch we reference the simple Hello Glib ACAP application. What is that? Is than an existing sample in acap-native-sdk-examples or acap-computer-vision-sdk-examples?
I don't think the reader at this point is familiar with the application, and if we cant add a link to the application I think we should remove the reference.
The name of the default branch is master
. We ought to discuss the pros and cons for keeping this name in favour of main
.
The following arguments are opposed to naming the default branch master
.
main
master
will be used more seldom. New project will be created with the name main
and many old project will probably migrate to the new name main
The following arguments are favouring the default branch master
.
master
, but an argument can be made that this will transition to be false given timeA declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.