Structure of the Project Directory #
This document describes directories generated by actdk init
.
app
model
include
manifesto
.actdk
.actdk/cache
.actdk/long_descriptions
app
#
app
is a directory for all scripts and executables running in the Actcast application.
ActDK transfers all the directories and files in app
into the Actcast application image.
model
#
model
is a directory for nnoir files, which are sources of conversion (from deep-learning models to stub codes) by actdk compile
.
include
#
The include
directory contains c-header files generated by actdk compile
to run the stub codes.
manifesto
#
The manifesto
directory contains manifesto files used to describe the resources needed at runtime.
The initialization process generates the files below.
default.json
pi4_or_later.json
The file names are arbitrary. You must specify what boards are supported and what devices are needed to run on the board.
.actdk
#
This directory contains configuration files about the project. The following files are stored:
dependencies.json
files.json
setting.json
dependencies.json
#
dependencies.json
specifies packages used in Actcast applications.
"apt"
"apt"
is for packages provided by Raspbian.
"pip"
"pip"
is for packages provided by pip3.
{
"apt": ["libraspberrypi0", "libraspberrypi-bin", "python3", "python3-pil"],
"pip": ["actfw-raspberrypi"]
}
You can specify dependencies for each target types for future extension. In target type wise dependencies, base_image
can be set.
{
"apt": ["python3", "python3-pil"],
"pip": [],
"raspberrypi-buster": {
"apt": ["libraspberrypi0", "libraspberrypi-bin", "python3-pil"],
"pip": ["actfw-raspberrypi"],
"base_image": "idein/actcast-rpi-app-base:buster-1"
}
}
"base_image"
(optional)"base_image"
is for Docker image that is used as the base of app.
files.json
#
files.json
configures the project structure.
It includes information about the Actcast application’s entry-point and the live monitoring script, but you don’t need to change this file for general usage.
{
"main": "main",
"healthchecker": "healthchecker",
"act_setting": "act_settings.json"
}
setting.json
#
setting.json
contains basic settings of the project.
This file is generated by actdk init
command automatically, but users can freely edit it by hand.
However, please notice that re-running actdk init
overwrites this file.
{
"app_id": "example",
"app_server_id": 48,
"short_description": "A test application",
"short_descriptions": {
"ja": "テストアプリケーション",
"eo": "Una testa aplikaĵo"
},
"target_types": [
"raspberrypi-buster"
],
"apt_repository": "http://one.of/raspbian/mirror"
}
"app_id"
- the application name
"app_server_id"
- the application ID
"short_description"
- the one-line description
"short_descriptions"
- One-line descriptions in languages other than English. Use language codes described in ISO 639-1 as property names and put the description in that language to values.
"target_types"
- Exists for future extension
"apt_repository"
- Used when you want to set up an apt mirror. mirror redirection system is used by default.
.actdk/cache
#
This directory is used by actdk
to store project-local cache data. Users must not edit this directory directly.
We recommend to add this path to .gitignore
if you use git to manage the project.
Before version 1.7.0 of actdk
, actdk
used .actdklastremote
and actdkbuildid
for this purpse.
Since version 1.7.0, these files are deprecated.
Some commands of actdk
automatically migrate these files to a new format if .actdk/cache/project_state.json
does not exist, and these files exist.
.actdk/long_descriptions
#
When you write descriptions in languages other than English, put the description files under this directory. Use language codes described in ISO 639-1 as file name.
To Application Development top