Installation Issues with the section of 'Installing the App Signing Tools' of the 'Distributing Your Branded Android App' Documentation

[dpapac]

Link to documentation:
https://doc.owncloud.com/branded_clients/next/branded_android_app/publishing_android_app.html

Problem: --> Installation of the App Signing Tools under OS: Ubuntu 20.04

$ sudo apt-get install openjdk-7-jre-headless
$ sudo apt-get install openjdk-7-jdk

Problem: -->By copying the commands via the provided Button from our Documentation $ signs are added to the begin of the command which will cause the commandline prompt :

$: command not found

After removal of the $ signs the packages can't be located or are not available

Solution: --> Installing the next available version:

sudo apt install openjdk-8-jdk-headless
sudo apt install openjdk-8-jdk

Problem: -->The next command has the same issue with the $ sign getting copied and the package name 'zlib1g:i386' is not going to be installed since it didn't got copied on the same line as the rest of the package names

$ sudo apt-get install libc6-i386 lib32stdc++6 lib32gcc1 lib32ncurses5
zlib1g:i386

Problem: -->The commandline prompt:

$: command not found

After the removal of the $ :

Solution: --> Still no packages got installed so I changed the command to:

sudo apt install libc6-i386
sudo apt install lib32stdc++6
sudo apt install lib32gcc1
sudo apt install zlib1g:i386

Problem --> One of the last package names wasn't able to be located under:

sudo apt install lib32ncurses5

Solution: -->After a research on google I found the command:

sudo apt install lib32ncurses5-dev

--> Install zipalign since I couldn't find it as described in our documentation

sudo apt install zipalign

Recommendation-->After downloading the 'android-studio....tar.gz' and unpacking it in the Downloads repository providing a default directory for installing the IDE would improve the experience of using the documentation e.G.:

sudo mv /home/$USER/Downloads/android-studio-2021.1.1.23-linux /opt
cd /opt/android-studio-2021.1.1.23-linux/android-studio/bin/
./studio.sh

The command ./studio.sh opens an 'Android Studio Setup Wizard' like in the picture below simply press next to continue:

In the next picture the user is asked for the Install Type for simplicity I have chosen Standard:

The next page asks the user to select an UI Theme choose as you wish: o Darcula(Dark Theme) o Light(Light Theme)
When the theme was chosen verify the settings by clicking on the button: Next

Afterwards you are asked to agree to the License Agreement accept the android-sdk-license and the android-sdk-preview-license it should look something like this:

Press Next to continue ...

Click and read through the remaining pages of the Setup Wizard and adjust to your needs. Make sure before clicking on install everything is configured to your needs. Click the Install Button to finalize the installation...-> Install

Android Studio was successfully installed.

The next steps of the Documentation after the Header 'Digitally Signing Your App' worked as intended.

[mmattel]

Hmmm, after reading this I am wondering where this really belongs to.
As far I recall there is no openjdk-7-jre-headless anywhere in this documentation as this is the user/admin-facing guide but not the developer one. Maybe to be transferred to the development repo. https://github.com/owncloud/android ?

But if this belongs to this repo, mind to reference using a link so I can take a closer look?

[mmattel]

Ah, just see that you changed your title, now contains Branded Android App...
In this case you may want to transfer this issue to the docs-client-branding repo
We are getting closer 😃

[mmattel]

I can help regarding copy/paste not using the $ sign at the beginning. Will take a look over the weekend.

[mmattel]

Reopening because other stuff needs to be fixed too, the referenced merged PR #25 did just fix one part.

[mmattel]

@dpapac one part is now fixed. Can you check what is missing/needs correction to finalize the remainig points? Maybe start with a comment with a drop list of items...

[dpapac]

Installation of the Java SE Platform:

CLICK ME 1

Issue: Packages can`t be located

Problem: The Packages can`t be located

sudo apt-get install openjdk-7-jre-headless
sudo apt-get install openjdk-7-jdk

Solution: I changed the command to the next available version:

sudo apt-get install openjdk-8-jre-headless
sudo apt-get install openjdk-8-jdk

Installation of required packages

CLICK ME 2

Issue: lib32ncurses5 can't be located

Problem: The Package 'lib32ncurses5' can't be located

sudo apt-get install libc6-i386 lib32stdc++6 \
    lib32gcc1 lib32ncurses5 zlib1g:i386

-> Solution: "lib32ncurses5-dev" as following:

sudo apt-get install libc6-i386 lib32stdc++6 \
    lib32gcc1 lib32ncurses5-dev zlib1g:i386

After Downloading android studio and unpacking it:

CLICK ME 3

A command to move android studio to a 'default directory' and starting the installation could enchance the experience of using our documentation e.g.:

sudo mv /home/$USER/Downloads/android-studio-2021.1.1.23-linux /opt
cd /opt/android-studio-2021.1.1.23-linux/android-studio/bin/
./studio.sh

Follow along setup wizard that pops up after the command './studio.sh'...

Installing tools

CLICK ME 4

Running this command from inside the unpacked directory didn't work for me as described:

tools/android update sdk --no-ui

What could be done to replace this or make it work ? -> Since this step didn't work the next step 'Couldn't find Zipalign as described in docu...' is neccessary which worked for me

Couldn't find Zipalign as described in the documentation:

CLICK ME 5

Install Zipalign

sudo apt install zipalign

[mmattel]

@dpapac I have edited the click me's and added a number for referencing what is fixed later on

[mmattel]

#26 is the fix for click me 1,2,5. Still open: 3,4

CM3: where should that be placed?
CM4: needs detailed input what has to be changed

Note that you can click Edit this page on the top right and add your changes (post merging #26 to have everything streamlined)

[mmattel]

Autoclosed by merge, reopen so that CM3 and CM4 can be fixed