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 70.8k 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

        @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
        • mimecarM Offline
          mimecar
          last edited by

          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 Reply Quote 3
          • T Offline
            Talkless @mimecar
            last edited by

            @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
            • mimecarM Offline
              mimecar
              last edited by mimecar

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

              advocatuxA 1 Reply Last reply Reply Quote 3
              • advocatuxA Offline
                advocatux @mimecar
                last edited by

                @mimecar looks great!

                1 Reply Last reply Reply Quote 0
                • EllypsisE Offline
                  Ellypsis
                  last edited by

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

                  1 Reply Last reply Reply Quote 0
                  • Pulsar33P Offline
                    Pulsar33 @flohack
                    last edited by

                    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)

                    advocatuxA 1 Reply Last reply Reply Quote 0
                    • advocatuxA Offline
                      advocatux @Pulsar33
                      last edited by

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

                      Pulsar33P 1 Reply Last reply Reply Quote 0
                      • Pulsar33P Offline
                        Pulsar33 @advocatux
                        last edited by

                        @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)

                        advocatuxA 1 Reply Last reply Reply Quote 0
                        • advocatuxA Offline
                          advocatux @Pulsar33
                          last edited by

                          @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
                          • Pulsar33P Offline
                            Pulsar33 @flohack
                            last edited by

                            @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)

                            flohackF 1 Reply Last reply Reply Quote 0
                            • flohackF Offline
                              flohack @Pulsar33
                              last edited by

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

                              My languages: 🇦🇹 🇩🇪 🇬🇧 🇺🇸

                              Pulsar33P 1 Reply Last reply Reply Quote 0
                              • Pulsar33P Offline
                                Pulsar33 @flohack
                                last edited by

                                @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

                                  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 Reply Quote 0
                                  • F Offline
                                    fulvio @shelllavie
                                    last edited by fulvio

                                    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 Reply Quote 1
                                    • shelllavieS Offline
                                      shelllavie @fulvio
                                      last edited by

                                      @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

                                        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 Reply Quote 0
                                        • F Offline
                                          fulvio @shelllavie
                                          last edited by fulvio

                                          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 Reply Quote 0
                                          • mimecarM Offline
                                            mimecar
                                            last edited by

                                            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.

                                            Pulsar33P 1 Reply Last reply Reply Quote 1
                                            • shelllavieS Offline
                                              shelllavie @fulvio
                                              last edited by

                                              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