• Categories
  • Recent
  • Tags
  • Popular
  • Users
  • Groups
  • Search
  • Register
  • Login
UBports Robot Logo UBports Forum
  • Categories
  • Recent
  • Tags
  • Popular
  • Users
  • Groups
  • Search
  • Register
  • Login

Ubuntu Touch Programming Course

Scheduled Pinned Locked Moved App Development
documentationubuntu touch
113 Posts 27 Posters 67.7k Views 12 Watching
Loading More Posts
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • U Offline
      UniSuperBox @mimecar
      last edited by 2 Aug 2018, 23:54

      @mimecar I know that everyone will have their opinion on your choice of technology, but I can say that document flow and downloadable formats are very good with Sphinx and ReStructuredText. At UBports, we mainly use Read the Docs to accomplish our documentation. The Godot game engine also uses Read the Docs for their documentation quite successfully.

      If you have any questions on using any of these technologies, drop me a PM and I'll be happy to help you get them set up.

      1 Reply Last reply Reply Quote 0
      • M Offline
        mimecar
        last edited by 9 Aug 2018, 18:42

        Good afternoon.

        I have dedicated this week to analyzing the different options that I have. For the facilities that it gives, I will use ReadTheDocs. Although it does not give me as much control as the other options (LaTeX, LibreOffice, etc.), it allows me to fulfill the needs that I have:

        • Reduced time since I finish an entry and it is published.
        • To be able to have the course in several formats (HTML, PDF, etc.)
        • Being able to have the documentation in several languages (facilitates collaborations)
        • Integrated with version control.

        I'm going to dedicate this month to migrate the course to ReadTheDocs. Next month there would be new delivery of the course. I still do not know if it will be at the beginning or at the end of the month.

        T 1 Reply Last reply 9 Aug 2018, 19:40 Reply Quote 3
        • T Offline
          Talkless @mimecar
          last edited by 9 Aug 2018, 19:40

          @mimecar said in Ubuntu Touch Programming Course:

          Next month there would be new delivery of the course.

          This is great news! Thanks a lot!

          Volla Phone X

          1 Reply Last reply Reply Quote 1
          • M Offline
            mimecar
            last edited by mimecar 8 Oct 2018, 16:18 10 Aug 2018, 15:27

            Second version of the doc 😛
            https://pbs.twimg.com/media/DkP8fMjXgAE1m3J.jpg:large

            A 1 Reply Last reply 10 Aug 2018, 16:28 Reply Quote 3
            • A Offline
              advocatux @mimecar
              last edited by 10 Aug 2018, 16:28

              @mimecar looks great!

              1 Reply Last reply Reply Quote 0
              • E Offline
                Ellypsis
                last edited by 19 Sept 2018, 23:49

                Hi @mimecar ! any news about your programming course? Do you need help on anything?

                1 Reply Last reply Reply Quote 0
                • P Offline
                  Pulsar33 @flohack
                  last edited by 20 Sept 2018, 05:33

                  Hello,
                  @flohack said in Ubuntu Touch Programming Course:

                  FYI we are in an experimental state with building the sdk again: https://github.com/ubports/usdk-image-tools/pull/1 - if this Pull Request is finally merged it should be able to generate a new SDK 🙂

                  BR

                  It seems that something was done some days ago. Is the good sdk available now ?
                  Best regards
                  Pulsar33

                  Aquaris BQ E5 HD UBports OTA-25 (currently testing features)
                  Aquaris BQ E5 HD Ubuntu Edition Canonical OTA-15 (last Canonical version, daily use)
                  Raspberry Pi 4 B - 4 GB & 8 GB with various OS and Desktops (UBports not OK)

                  A 1 Reply Last reply 20 Sept 2018, 07:13 Reply Quote 0
                  • A Offline
                    advocatux @Pulsar33
                    last edited by 20 Sept 2018, 07:13

                    @pulsar33 just in case you don't know it, @dobey is working on https://github.com/dobey/ergo

                    P 1 Reply Last reply 24 Sept 2018, 08:09 Reply Quote 0
                    • P Offline
                      Pulsar33 @advocatux
                      last edited by 24 Sept 2018, 08:09

                      @advocatux : thanks but I don't find a thread speaking of that on this forum and github is a bit vague for me.

                      @Flohack : any news ?

                      Best regards
                      Pulsar33

                      Aquaris BQ E5 HD UBports OTA-25 (currently testing features)
                      Aquaris BQ E5 HD Ubuntu Edition Canonical OTA-15 (last Canonical version, daily use)
                      Raspberry Pi 4 B - 4 GB & 8 GB with various OS and Desktops (UBports not OK)

                      A 1 Reply Last reply 24 Sept 2018, 09:05 Reply Quote 0
                      • A Offline
                        advocatux @Pulsar33
                        last edited by 24 Sept 2018, 09:05

                        @pulsar33 what I meant with that post is just to let you know that there will be a new toolkit 🙂

                        1 Reply Last reply Reply Quote 0
                        • P Offline
                          Pulsar33 @flohack
                          last edited by 30 Sept 2018, 12:02

                          @flohack said in Ubuntu Touch Programming Course:

                          FYI we are in an experimental state with building the sdk again: https://github.com/ubports/usdk-image-tools/pull/1 - if this Pull Request is finally merged it should be able to generate a new SDK 🙂

                          BR

                          @Flohack : I read on your link :

                          • Generate the SDK for Ubports #1
                            Merged
                            mardy merged 5 commits into ubports:master from mardy:ubports 21 days ago

                          But I'm not sure to understand. Can we use now the Ubuntu Touch Programming Course with the good sdk ?

                          Best regards
                          Pulsar33

                          Aquaris BQ E5 HD UBports OTA-25 (currently testing features)
                          Aquaris BQ E5 HD Ubuntu Edition Canonical OTA-15 (last Canonical version, daily use)
                          Raspberry Pi 4 B - 4 GB & 8 GB with various OS and Desktops (UBports not OK)

                          F 1 Reply Last reply 1 Oct 2018, 19:02 Reply Quote 0
                          • F Offline
                            flohack @Pulsar33
                            last edited by 1 Oct 2018, 19:02

                            @pulsar33 Me neither, please ask @mardy or @mimecar 🙂

                            My languages: 🇦🇹 🇩🇪 🇬🇧 🇺🇸

                            P 1 Reply Last reply 2 Oct 2018, 06:59 Reply Quote 0
                            • P Offline
                              Pulsar33 @flohack
                              last edited by 2 Oct 2018, 06:59

                              @flohack : Hello Flohack
                              Thanks for the answer anyway
                              @mimecar never replied me ...
                              @mardy I don't know ...

                              It seems that there are some explanations in this new thread (work in progress)

                              Have a nice day
                              Pulsar33

                              Aquaris BQ E5 HD UBports OTA-25 (currently testing features)
                              Aquaris BQ E5 HD Ubuntu Edition Canonical OTA-15 (last Canonical version, daily use)
                              Raspberry Pi 4 B - 4 GB & 8 GB with various OS and Desktops (UBports not OK)

                              1 Reply Last reply Reply Quote 0
                              • shelllavieS Offline
                                shelllavie
                                last edited by 3 Oct 2018, 07:19

                                Hi, everyone!

                                I´m starting to play with the examples in the book in order to build my own apps. Just last night I used clickable to run the WeatherRecorder app on my desktop (xenial); everything ran pretty well except for the images temperature.png and search.png not loading.

                                The terminal complains it cannot find them in the build path. Any ideas?

                                Thanks in advance.

                                F 1 Reply Last reply 3 Oct 2018, 09:26 Reply Quote 0
                                • F Offline
                                  fulvio @shelllavie
                                  last edited by fulvio 10 Mar 2018, 09:46 3 Oct 2018, 09:26

                                  Hi @shelllavie
                                  the sample applications ”WeatherRecorder” and ”WeatherRecorderChart” was made using the Ubuntu-sdk-ide.
                                  After writing them, that tool was deprecated and replaced by ‘clickable’.

                                  Running the the sample apps with clickable can be little issues.


                                  Issue 1: icon images .png ( temperature.png and search.png) are not showed when the running on a device (or desktop) and are not include in .click package.

                                  Fix: Add this:
                                  $$files(*.png,true) \
                                  at the existing entry “QML_FILES” in the WeatherRecorde.pro file
                                  the one placed inside the folder containing .png icon and qml files).
                                  With that modification should like this:

                                  QML_FILES += $$files(.qml,true)
                                  $$files(
                                  .png,true)
                                  $$files(*.js,true)


                                  Issue 2: there are incongruous values for ‘applicationName’ parameters in Main.qml and “manifest.json.in” files.
                                  This could cause an error when trying to run the application on a device.

                                  Fix: Align the values in “Main.qml” and “manifest.json.in” to have the same value in both files.

                                  In Main.qml
                                  applicationName: "weatherrecorderchart"

                                  manifest.json.in
                                  "name": "weatherrecorderchart",


                                  I can't update sources on github because the owner of the repo is mimecar.

                                  tnx

                                  shelllavieS 1 Reply Last reply 3 Oct 2018, 11:53 Reply Quote 1
                                  • shelllavieS Offline
                                    shelllavie @fulvio
                                    last edited by 3 Oct 2018, 11:53

                                    @fulvio
                                    Hi @fulvio!

                                    Thanks for the valuable info and for the apps (they contain a high teaching value) 🙂

                                    1 Reply Last reply Reply Quote 0
                                    • shelllavieS Offline
                                      shelllavie
                                      last edited by 7 Oct 2018, 12:42

                                      Happy Sunday everyone!

                                      @fulvio or anyone who knows:

                                      How to make the weatherrecorderchart app responsive? I thought the "width: units.gu(110) ..." bit in the Main.qml file would do the job, but after installing it on my BQ E5 the view doesn't fit the screen resolution. Any ideas would be really appreciated.

                                      Bye for now!0_1538916160871_photo_2018-10-07_14-42-03.jpg

                                      F 1 Reply Last reply 7 Oct 2018, 18:41 Reply Quote 0
                                      • F Offline
                                        fulvio @shelllavie
                                        last edited by fulvio 10 Jul 2018, 18:42 7 Oct 2018, 18:41

                                        Hi @shelllavie
                                        that is a known "problem" not solved to introduce the next chapter topic about adapting the sample application layout at the device screen (phone or tablet).
                                        I have sent the chapter to @mimecar some time ago but due to an important issue Miguel suspended the course for a while (maybe you know about that, if you are subscribed at the course Telegram channel). I don't know when will be published (i am not the owner of the course, i have only written only some contents).

                                        To solve the application size issue you can use a Layout named "ConditionalLayout" (https://api-docs.ubports.com/sdk/apps/qml/Ubuntu.Layouts/ConditionalLayout.html?highlight=conditionallayout).

                                        Another solution could be use a "Loader" component (https://api-docs.ubports.com/sdk/apps/qml/Ubuntu.Layouts/ConditionalLayout.html?highlight=conditionallayout).

                                        Useful links:
                                        https://askubuntu.com/questions/446755/what-does-gu-stand-for
                                        https://blog.ubuntu.com/2015/06/16/the-grid-system-in-detail

                                        Tnx

                                        shelllavieS 1 Reply Last reply 8 Oct 2018, 07:34 Reply Quote 0
                                        • M Offline
                                          mimecar
                                          last edited by 7 Oct 2018, 19:40

                                          Goodnight.

                                          First of all I want to apologize for having the course so stopped. At the end of April an event occurred that has affected me a lot. For that reason, anything that is not day to day has been stopped. Little by little I'm recovering but it's hard for me to continue.

                                          In my planning I thought I would have migrated the course to Sphinx at the end of September. This has not been possible and I think that for the moment I will continue with GitBook. I will move to the new version even if I lose the documentation in PDF / ePub format. Later I'll make the migration to Sphinx.

                                          @shelllavie, I write down the changes and add them in the next update. If you see that I forget to do it, you remind me.

                                          @Pulsar33, Sorry for not answering. I read the forum but I have to take time to answer. I have not checked if the new SDK works, but remember that you can use the version that exists in the virtual machine of the course.

                                          If I have an answer for answering, don't hesitate to ask me. I will try to answer on the same day.

                                          Greetings.

                                          P 1 Reply Last reply 8 Oct 2018, 07:52 Reply Quote 1
                                          • shelllavieS Offline
                                            shelllavie @fulvio
                                            last edited by 8 Oct 2018, 07:34

                                            Hi @fulvio!

                                            Thanks for the info about ConditionalLayout and the links.

                                            @mimecar No problem, mate; hopefully the course will move on little by little. Thanks a lot for it.

                                            Cheers!

                                            1 Reply Last reply Reply Quote 0
                                            • First post
                                              Last post