Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translation of page introduction/chapter-02-s02 #17

Open
JassMan23 opened this issue Nov 19, 2018 · 0 comments
Open

Translation of page introduction/chapter-02-s02 #17

JassMan23 opened this issue Nov 19, 2018 · 0 comments

Comments

@JassMan23
Copy link

JassMan23 commented Nov 19, 2018

Sorry, I am new to all this gitbook stuff but I noticed that the high quality of of the book is slightly let down by this page: qt-course/en/chapter-02-introduction/chapter-02-s02
I notice the source has a button marked "fork this project", is this what I should have done? Is there a way for you to merge it back, if I had?"

The new development environment
The new environment changes ONLY the tools used for application development; ALL the concepts exposed in the previous chapters (QML, JavaScript...) are valid again ! Also the source code don't --> doesn’t need modifications to be compliant with the new environment.
In the previous chapters of this course we have used Ubuntu SDK-IDE as the "official" development tool.
Now the situation is-->has changed: UBports community decided to deprecate that SDK-IDE and his its related tools like phone emulator (more info at: Clickable for Atom). The UBports community environment will be exposed in this section.
If you don’t want to leave Ubuntu SDK-IDE, an unofficial alternative, is use the Virtual Machine based on 16.04 with Ubuntu sdk-ide provided with this course. You can download it from this link​
#the following para looks correct in the .md but hasn't formatted correctly
The UBports development environment is composed of three parts:

  1. Atom editor
  2. Clickable as tool to build, compile and run applications.
  3. atom-build-clickable an Atom plugin to use Clickable from Atom
    For deeper informations about them, please, see their web site: we’ll present only the necessary informations.

Clickable
Clickable is a command line tool to build, run and deploy Ubuntu Touch (UBports) applications. Currently the last stable version is the 5.0.0. To install it or get the official documentation visit this link. We don’t report here the installation steps because are already well explained on the web site.
Note: If you have an Nvidia graphic card, we suggest to use-->using the open source Nvidia driver (named "Nouveau") not the closed source version, currently there could be little issues using the new development environment.
All Clickable features are available with his-->the executable named "clickable" (its not necessary be root to use it).
At-->The configuration level introduces a new file descriptor named "clickable.json" to be placed in the root source folder of the application (the one with "manifest.json" and ".pro" files). See: clickable.json Format.
That file descriptor is created when a NEW clickable project is created using the command "clickable create" (or "clickable init" for previous clickable versions). In the case of-->where this file is missing (for example application made with Ubuntu-sdk-ide) we will show later how to create it.

Atom
Atom: is an open source editor that can be extended with many plugins. UBports community has developed a new plugin to add new features related at Ubuntu Touch application development.
Atom can be installed with “Ubuntu Software Center” or downloading the package from Atom Web Site​
If you choose the second installation method, to install it use this command (for Debian like distro):
sudo dpkg -i atom-amd64.deb
After a successful installation it is necessary to proceed with the installation of UBports plugin named atom-build-clickable Here we refer at the last available version, the 0.3.0
Search it from Atom menu: "Edit" → "Preferences" → "install". During the installation, if Atom ask you to install other plugins required by Clickable one, accept.
The current version of the plugin, allows you to build and run applications without the use of command line (ie use "clickable" command). NOTE: the plugin is currently under development and some features could be missing.
We suggest also to install the plugin "language-qml" (NOT developed by UBports community) to have a basic syntax highlight for QML files. Also a Javascript plugin available for Atom, can be useful.
IMPORTANT: "atom-build-clickable" plugin is active only when the opened folder/project contains the file descriptor "clickable.json" used by Clickable tool. When active, you can see a "Clickable" menu entry in **the **Atom menu bar and a new one in the bottom left part (next image).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant