Eintwicklung/BuildingFürAndroid

    From The Document Foundation Wiki
    This page is a translated version of the page Development/BuildingForAndroid and the translation is 9% complete.

    Die Android SDK installieren

    It might be simplest to install the Android Studio: https://developer.android.com/studio

    • Sobald heruntergeladen, extrahieren und führen sie "<android_studio_dir>/bin/studio.sh" aus.
    • Nach einigen Sekunden erscheint eine grafische Oberfläche und führt sie (wählen sie die Standarteinstellungen, falls sie noch nie Android Studio installiert haben) durch den Konfigurationsprozess und das Herunterladen von Komponenten (inklusive der SDK)
    • Es könnte ein "mksdcard"-Fehler am Ende dieses Prozesses erscheinen.
    • Es wird einen Ordner namens "~/Android/Sdk" geben, dies ist ihr "ANDROID_HOME"
    • Go to File > Settings
      • Type "SDK" into the search bar in the top-left corner.
      • or follow Appearance & Behaviour > System Settings > Android SDK
        • Here, install the latest SDK (or whichever you need/ prefer)

    It is also possible to download the "Android SDK Platform-Tools" here https://developer.android.com/studio/releases/platform-tools and use the sdkmanager to install an SDK.

    Go to Tools ▸ Android ▸ SDK Manager in Android Studio, Android SDK and go to SDK Tools tab, there click on NDK and install it.

    How to build it

    The build instructions are very similar to the normal How To Build instructions.

    We develop on Linux as the host environment. Windows is not supported. When you have the NDK and SDK, clone the git repo:

    git clone git://gerrit.libreoffice.org/core libreoffice
    cd libreoffice

    Create your autogen.input, so that it looks like (please use full path instead of ~):

    # ARM Android
    --with-distro=LibreOfficeAndroid
    # or Android x86 ( preferable if using an AVD Emulator )
    --with-distro=LibreOfficeAndroidX86
    --with-android-sdk=~/Android/Sdk
    --with-android-ndk=~/Android/Sdk/ndk-bundle
    

    Configure (and install packages as needed) and build

    ./autogen.sh
    make

    How to run it

    cd android/source
    make install

    This will install the .apk to the default emulator or device.

    Hacking it

    We appreciate any help with the development - every patch counts :-) If you don't know what to work on, have a look at the open Bugzilla tickets filed for the Android Viewer.

    More information about the development can be found in:

    Hints

    If you want to speed-up your development cycle, use the Icecream distributed compiler. Specific instructions how to set it up for cross-compiling LibreOffice on Android are in the Using Icecream to speed up the LibreOffice Android build blog post.

    gtktiledviewer

    gtktiledviewer is a test app that allows development of the LOK API implementations in LO core without any additional complexity (Android or Online both add complexity).

    See the gnome-documents page about how to use the underlying GTK widget with that frontend.

    At the moment gtktiledviewer has no testsuite, so here is a checklist to do manual testing if there is some larger rework on it.

    Basic feature set:

    1. Click inside a paragraph. Result: Caret appears at the position where the user clicked.
    2. Click inside a paragraph, start typing. Result: text appears in the application.
    3. Click inside a bullet list, type Enter. Result: new bullet is inserted, caret is on the new line.
    1. Double-click inside a paragraph. Result: entire word is selected, the selection has handles to allow shrinking or growing the selection.
    2. Drag the shown handles inside the paragraph. Result: the selection grows or shrinks according to the movements.
    3. Text is selected, type a word. Result: The selected text is deleted, the word is typed in.
    1. Double-click inside a cell in a table or a spreadsheet. Result: If empty, the entire cell is selected. If any text is there, the closest word is selected. If the handles are dragged outside of the cell boundary, selection turns into a able selection.
    2. Click on an image. Result: selection rectangle of the image (including handles) appears.
    3. Drag the image's selection handles. Result: The image is resized, keeping the aspect ratio.
    1. Click on a text inside a shape. Result: Caret appears inside the shape text.
    2. Click on the border of a shape. Result: Bounding box of the shape appears as the selection, including handles to manipulate the object.
    3. Drag a handle of the shape's selection. Result: The shape resizes according to the drag. The resizing does not keep aspect ratio.
    4. Select text (double-click on a word), trigger Bold action on the toolbar. Result: The selected text will be emboldened.

    Features implemented after the TDF-funded project ended:

    1. Search for something in the document. The search result is highlighted.
      1. If the document is an Impress one, then if the search result is on a next slide, the viewer switches to that slide automatically and the part selector is updated.
      2. If the search term is not found, the findbar is updated to say so.
      1. If nothing is selected, then search starts from the top left corner of the visible area, not from the cursor position.
    1. Desktop-style selection with the mouse (click somewhere, then drag the mouse to the end position).
    2. Progress-bar on load.
    3. Clicking on a hyperlinks opens the URL in a browser.
    1. Add or remove enough content to/from a Writer document so the number of pages changes. The viewer should update the document size correctly. (E.g. scrollbars.)
    2. Select Writer text, copy, paste to e.g. abiword: formatting should be preserved, as HTML is used for copying.
    3. Select Writer shape text, paste to abiword, at least plain text should show up, as it's detected that HTML is not supported.
    1. Switch Impress slides, type text after the slide change -- text should appear. (Focus does not remain on the part selector widget.)
    2. Switch Calc sheets, after sheet switch the contents of the new sheet is visible. (Tiles from the old sheet are not kept.)