Difference between revisions of "LAMW"

From Lazarus wiki
Jump to navigationJump to search
(Add LAMW github page link)
 
(58 intermediate revisions by 10 users not shown)
Line 1: Line 1:
−
== Note ==
+
{{LanguageBar}}
−
This is quick copy of the tutorial HOW_TO_INSTALL_by_Dieselnutjob.pdf (for Windows)
 
−
Images and other details should come ASAP.
 
  
−
Installation for Linux will be added later, for now you can checkout https://github.com/jmpessoa/lazandroidmodulewizard and read linux/new_how_to_install_by_renabor.txt.
+
{{Platform only|Android|Android|Android}}
  
 +
[[File:lamw_git_small_circle.png|link=https://github.com/jmpessoa/lazandroidmodulewizard|LAMW]]
  
−
== What is LAMW ==
+
'''LAMW''': Lazarus Android Module Wizard is a wizard to create JNI Android loadable module (.so) and Android Apk using Lazarus/Free Pascal.
  
−
This is a set of ''Lazarus wizards'' you will launch from menus Build and Tools.
 
  
−
It helps to set parameters, organize libraries and to run the tools required to make APK files, used to install applications on '''Android'''.
+
'''Features:'''
  
 +
: Native Android GUI
 +
::: AppCompat and Material Design supported!
  
−
== How to install on Windows ==
+
: RAD! Form designer and drag&drop component development model!
 +
::: More than 140 components!
 +
: Github Page: https://github.com/jmpessoa/lazandroidmodulewizard
  
−
This is working on Windows 8 and 10 Home Edition 64 bits.
 
  
−
=== 1) Downloads ===
+
== Get Lazarus for Android ==
  
−
Create folders C:\lamw and C:\lamw\projects
+
===Laz4Android 2.0.12 (Windows)===
  
−
Download these files in the folder C:\lamw :
+
: All cross-android compilers already installed!
  
−
[http://dl.google.com/android/android-sdk_r24.4.1-windows.zip SDK 24.4.1]
+
: arm-android/aarch64-android/i386-android/x86_64-android/jvm-android
  
−
[http://dl.google.com/android/repository/android-ndk-r10e-windows-x86.zip NDK r10e]
 
  
−
[http://archive.apache.org/dist/ant/binaries/apache-ant-1.9.6-bin.zip Ant 1.9.6]
+
; How to
  
−
[http://download.oracle.com/otn-pub/java/jdk/8u65-b14/jdk-8u65-windows-i586.exe jdk-8u65-windows-i586.exe Jdk 8u65]
+
: Install * [http://sourceforge.net/projects/laz4android/files/?source=navbar Laz4Android 2.0.12]
  
−
[https://sourceforge.net/projects/laz4android/files/laz4android1.5-50093-FPC3.1.1.7z/download Laz4Android 1.5-50093-FPC3.1.1]
+
{{Note|Install here: "C:\laz4android2.0.12"  (not "Program Files" !!!)}}
  
−
[[File:lamw_download.png]]
+
: Install * [https://github.com/jmpessoa/lazandroidmodulewizard/archive/master.zip LAMW]
  
−
Checkout with a svn client (Tortoise SVN )
+
{{Note|Download LAMW and unzip it in some folder (ex. "C:\laz4android2.0.12\components")}}
  
−
https://github.com/jmpessoa/lazandroidmodulewizard to C:\lamw\lazandroidmodulewizard
+
:: Packages installations order/sequence:
  
−
[[File:lamw_svn_checkout_1.png]]
+
::: tfpandroidbridge_pack.lpk (in "..../android_bridges" folder)
 +
::: lazandroidwizardpack.lpk (in ""..../android_wizard" folder)
 +
::: amw_ide_tools.lpk (in "..../ide_tools" folder)
  
−
[[File:lamw_svn_checkout_2.png]]
+
; Go to [[#Infrastructure|Infrastructure]].
  
−
'''Important Notes :'''
+
===LAMW Manager (Linux and Windows)===
  
−
Versions specified here are currently working, although some of them are old and even hidden by their creator/publisher.
+
{{Note|All in One! LAMW Manage produces a complete Lazarus for Android environment by automating the step [[#Infrastructure|Infrastructure]]!}}
  
−
But the latest stable versions are not always compatible with the tool (NDK at least).  
+
: Install * [https://github.com/dosza/LAMWManager-linux LAMW Manager Installer for Linux]
 +
: Install * [https://github.com/dosza/LAMWManager-win LAMW Manager Installer for Windows]
  
−
If a more recent stable version is found working well, please update the Wiki.
+
===Install LAMW using fpcupdeluxe (Linux and Windows)===
  
−
You may have already the kits installed somewhere else on your computer. It might lead to problems if you try to re-use them. The safer is to make new downloads in c:\lamw. Be aware to use the corresponding versions and do not use shortcuts previously installed with other versions.
+
:: [https://wiki.freepascal.org/LAMW_install_linux_fpcupdeluxe How to install on Linux (FPCUPdeluxe + LAMW)]
 +
:: [https://wiki.freepascal.org/LAMW_install_windows_fpcupdeluxe How to install on Windows (FPCUPdeluxe + LAMW)]
  
−
=== 2) Installations ===
+
===Do It Yourself! (Windows)===
  
−
Extract android-sdk_r24.4.1-windows.zip in c:\lamw\android-sdk_r24.4.1-windows
+
: Install * [https://sourceforge.net/projects/lazarus/files/Lazarus%20Windows%2064%20bits/Lazarus%202.0.12/lazarus-2.0.12-fpc-3.2.0-win64.exe/download Lazarus 2.0.12]
  
−
Extract android-ndk-r10e-windows-x86.zip in c:\lamw\android-ndk-r10e-windows-x86
+
{{Note|Install here: "C:\lazarus2.0.12"  (not "Program Files" !!!)}}
  
−
Extract apache-ant-1.9.6-bin.zip in c:\lamw\apache-ant-1.9.6
+
: Install * [https://github.com/jmpessoa/lazandroidmodulewizard/archive/master.zip LAMW]
  
−
Extract laz4android1.5-50093-FPC3.1.1.7z to C:\lamw\Laz4Android
+
{{Note|Download LAMW and unzip it in some folder (ex. "C:\lazarus2.0.12\components")}}
  
−
Execute jdk-8u65-windows-i586.exe . It will install the JDK to C:\Program Files (x86)\Java\jdk1.8.0_65\
+
:: Packages installations order/sequence:
  
−
'''Notes :'''
+
::: tfpandroidbridge_pack.lpk (in "..../android_bridges" folder)
 +
::: lazandroidwizardpack.lpk (in ""..../android_wizard" folder)
 +
::: amw_ide_tools.lpk (in "..../ide_tools" folder)
  
−
Depending on the tool you use to extract zip or 7z, be sure to have not the first folder twice.
+
: Install * [https://gitlab.com/freepascal.org/fpc/source/-/archive/main/source-main.zip FPC source code (trunk)]
  
−
Something like c:\lamw\android-ndk-r10e-windows-x86\android-ndk-r10e-windows-x86 will lead to errors below...
+
:: Download FPC source code and unzip it in some folder and point up the source path in next step
  
−
== 3) Update Java development kits ==
 
  
−
run C:\lamw\android-sdk-windows\SDK Manager.exe
+
: Go to Lazarus menu "Tools" >> "[LAMW] Android Module Wizard" >> "Build FPC Cross Android"
  
−
# deselect Android 6.0 (API 23)
+
{{Note|repeat the "Build and install" process  once for each architecture}}
−
# select Android SDK Platform-tools
 
−
# select Android SDK Build-tools
 
−
# select Android Support Library
 
−
# select Google USB Driver
 
−
# click Install 4 packages
 
−
# Accept license and click Install
 
−
# wait for downloads to finish
 
−
# Exit SDK Manager
 
−
[[file:lamw_sdk_manager_1.png]]
 
  
 +
::: (x) Armv7a + Soft (android 32 bits << tested!)
  
−
Run C:\lamw\android-sdk-windows\SDK Manager.exe again
+
:::: Build
  
−
# deselect Android 6.0 (API 23)
+
:::: Install
−
# expand Android 4.2.2 (API 17)
 
−
# select SDK Platfrom
 
−
# select ARM EABI v7a System Image
 
−
# click Install 2 packages
 
−
# Accept license and click Install
 
−
# wait for downloads to finish
 
−
# Exit SDK manager
 
−
[[file:lamw_sdk_manager_2.png]]
 
  
−
== 4) Build and prepare Laz4Android ==
+
::: (x) Aarch64 (android 64 bits << tested!)
  
−
From Windows, run cmd, then :
+
:::: Build
  
−
cd \lamw\Laz4Android
+
:::: Install
−
build.bat
 
  
−
[[file:lamw_cmd_laz4android_1.png]]
+
{{Note|After "build" and "install" the cross-compilers and after to do  all [[#Infrastructure|Infrastructure]] go to [[#Using LAMW|Using LAMW]] and try to create your first [New] LAMW project!}}
  
−
[[file:lamw_cmd_laz4android_2.png]]
+
:If you get an error "Fatal: Cannot find unit system used by fcllaz of package FCL" when trying "Run"  >> "Build"  your project then go to "fpc.cfg"  (ex. "C:\lazarus2.0.12\fpc\3.2.0\bin") and:
  
−
When finished, exit cmd mode
+
:: '''change:'''
  
−
Create a shortcut on your desktop for C:\lamw\laz4android\startlazarus.exe
+
::: #searchpath for units and other system dependent things
  
−
Execute it
+
::: -FuC:\lazarus2.0.12\fpc\$FPCVERSION/units/$fpctarget
  
−
Start IDE
+
::: -FuC:\lazarus2.0.12\fpc\$FPCVERSION/units/$fpctarget/*
 +
 +
::: -FuC:\lazarus2.0.12\fpc\$FPCVERSION/units/$fpctarget/rtl
 +
 
 +
:: '''to:'''       
 +
 
 +
::: #searchpath for units and other system dependent things
 +
 
 +
::: -FuC:\lazarus2.0.12\fpc\3.2.0/units/$fpctarget
  
−
Package -> Open package file (.lpk)
+
::: -FuC:\lazarus2.0.12\fpc\3.2.0/units/$fpctarget/*
 +
 +
::: -FuC:\lazarus2.0.12\fpc\3.2.0/units/$fpctarget/rtl
  
−
select C:\lamw\lazandroidmodulewizard\trunk\tfpandroidbridge_pack.lpk
+
         
 +
: And go to Lazarus IDE menu "Tools" >> "Options" >> "Environment" >> [FPC Source]
  
−
Compile
+
::'''change:'''
  
−
Use>> Install
+
::: $(LazarusDir)fpc\$(FPCVer)\source
  
−
Do you want to rebuid Lazarus now? Yes
+
:: '''to:'''
−
+
                       
−
Laz4Android will restart
+
::: $(LazarusDir)fpc\3.2.0\source
 +
         
 +
 
 +
==Infrastructure==
 +
 
 +
{{Note|Only for non-users of LAMW Manager!}}
 +
 
 +
===Get Java JDK===
 +
: Install * [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java JDK 8]
 +
 
 +
===Get Android NDK===
 +
: Install * [https://github.com/android/ndk/wiki/Unsupported-Downloads r19c]
 +
 
 +
===Get Ant builder===
 +
: Install * [http://ant.apache.org/bindownload.cgi Ant]
  
−
Package -> Open package file (.lpk)
+
:: Simply extract the zip file to a convenient location...
  
−
select C:\lamw\lazandroidmodulewizard\trunk\lazandroidwizardpack.lpk
+
===Get Gradle builder===
 +
: Install * [https://gradle.org/next-steps/?version=6.6.1&format=bin Gradle 6.6.1]
  
−
Compile
+
{{Note|Use the option "extract here" to produce the folder "gradle-6.6.1" in a convenient location...}}
  
−
Use>> Install
+
===Get Android SDK===
 +
: Install * [https://dl.google.com/android/repository/tools_r25.2.5-windows.zip r25.2.5-windows]
  
−
Do you want to rebuid Lazarus now? Yes
+
: Install * [https://dl.google.com/android/repository/tools_r25.2.5-linux.zip r25.2.5-linux]
  
−
Laz4Android will restart
+
: Install * [https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip r25.2.5-macosx]
  
−
Package -> Open package file (.lpk)
+
; How to
  
−
select C:\lamw\lazandroidmodulewizard\trunk\ide_tools\amw_ide_tools.lpk
+
: unpacked/install to a "sdk" folder
  
−
Compile
+
: open a command line terminal and go to folder "sdk/tools"
  
−
Use>> Install
+
: run the command  >> "android update sdk"  to open a GUI "SDK Manager"
  
−
Do you want to rebuid Lazarus now? Yes
+
:: Go to [Tools] and keep "as is"
  
−
Laz4Android will restart
+
::: Android SDK Tools  (installed)
 +
::: (x) Android SDK Platform-Tools
 +
::: (x) Android SDK Build-Tools 29.0.3 (and others more recent)
  
−
== 5) Path settings ==
+
:: Go to [Android R] and uncheck all!
  
−
In Laz4Android :
+
:: Go to [Android 10 API 29] uncheck all and check only
  
−
Tools -> [LAMW] Android Module Wizard -> Path settings
+
::: (x)SDK Platform
  
−
Path to Java JDK: C:\Program Files (x86)\Java\jdk1.8.0_65
+
:: Go to [Extras] and check:
−
Path to Ant bin: C:\lamw\apache-ant-1.9.6\bin
 
−
Path to Android SDK: c:\lamw\android-sdk_r24.4.1-windows
 
−
Path to Android NDK: C:\lamw\android-ndk-r10e
 
−
NDK version: 10e
 
−
Path to Simonsay's templates: C:\lamw\lazandroidmodulewizard\trunk\java
 
  
−
[[File:lamw_path_settings.png]]
+
::: (x)Android Support Repository
  
−
OK.
+
::: (x)Google USB Drive (Windows only...)
  
−
File -> Restart
+
::: (x)Google Repository
  
−
== 6) Create your first project ==
+
::: (x)Google Play Services
  
−
In Laz4Android :
+
:: [Install 7 package!]
  
−
Project -> Close project  [if necessary]
 
  
−
Project Wizard -> New project
+
==Using LAMW==
  
−
Select JNI Android Module [Lamw GUI]
+
===Configure Paths===
  
−
OK
+
: Lazarus IDE menu "Tools" >> "[LAMW] Android Module Wizard" >>  "Paths Settings ..."
 +
 
 +
{{Note|MacOs: path to Java JDK auto setting!}}
  
−
[[file:lamw_create_new_project.png]]
+
===Create and Run your first Android Apk===
  
−
Path to Workspace [Projects Folder]: C:\lamw\projects
+
; How to
−
New Project Name: LamwGUIProject1
 
−
Default Package Name: org.lamw
 
−
Include "android-support-v4.jar": no
 
−
NDKPlatfom: 17
 
−
MinSdkAPI: 17
 
−
TargetSdkApi: 17
 
−
Instruction: ARMv7a
 
−
ARM Fpu: Soft
 
−
Android Theme: DeviceDefault
 
  
−
[[File:lamw_configure_project.png]]
+
: From Lazarus IDE select "Project" >> "New Project"
  
−
Save unit1.pas
+
: From displayed dialog select "[LAMW] GUI Android Module" and "Ok"
  
−
Click ''Save''
+
: Fill the form/dialog fields and "Ok"
  
−
Now, if you hover the mouse over any unit in uses clause, IDE will show an error message.
+
{{Note|Path to Workspace" is your projects folder}}
  
−
File -> Restart
+
{{Note|Accept "default" options! (but pay attention to the * signage)}}
  
−
After restart, if you hover the mouse over any unit in uses clause, IDE does not show error message anymore
+
: "Save"  unit1 as/where suggested
  
−
Drag from Android Bridge a ''jButton'' onto form
+
{{Note|Search your project folder... you will find many treasures there! (look for lazarus project in ".../jni" folder)}}
 +
 
 +
: From Lazarus IDE select "Run" >> "Build"
  
−
Events OnClick, double click and add :
+
:: '''Success!''' Your system is up to produce your first Android Apk!
  
−
procedure TAndroidModule1.jButton1Click(Sender: TObject);
 
−
begin
 
−
ShowMessage('Hello World');
 
−
end;
 
  
−
File -> Save All
+
: Configure your phone device to [https://developer.android.com/studio/debug/dev-options debug mode] and plug it to the computer usb port
  
−
Run -> Build
 
  
−
Target: C:\lamw\projects\LamwGUIProject1\libs\armeabi\libcontrol.so: Success
+
: From Lazarus IDE select "Run" >> "[LAMW] Build Apk and Run"
  
−
Run -> [Lamw] Build APK and run
+
:: '''Congratulations!''' You are now an Android Developer!
  
−
Building APK...: Success
+
==Other references==
  
−
Copy C:\lamw\projects\LamwGUIProject1\bin\LamwGUIProject1-debug.apk to the Android device
+
[https://github.com/jmpessoa/lazandroidmodulewizard/blob/master/docs/AppHelloWorld.md Tutorial: My First "Hello Word" App]
  
−
Install using phone file manager
+
[[Category:Lazarus]]
 +
[[Category:Android]]

Latest revision as of 01:29, 23 May 2023

│ English (en) │ polski (pl) │ русский (ru) │

Android robot.svg

This article applies to Android only.

See also: Multiplatform Programming Guide

LAMW

LAMW: Lazarus Android Module Wizard is a wizard to create JNI Android loadable module (.so) and Android Apk using Lazarus/Free Pascal.


Features:

Native Android GUI
AppCompat and Material Design supported!
RAD! Form designer and drag&drop component development model!
More than 140 components!
Github Page: https://github.com/jmpessoa/lazandroidmodulewizard


Get Lazarus for Android

Laz4Android 2.0.12 (Windows)

All cross-android compilers already installed!
arm-android/aarch64-android/i386-android/x86_64-android/jvm-android


How to
Install * Laz4Android 2.0.12
Light bulb  Note: Install here: "C:\laz4android2.0.12" (not "Program Files" !!!)
Install * LAMW
Light bulb  Note: Download LAMW and unzip it in some folder (ex. "C:\laz4android2.0.12\components")
Packages installations order/sequence:
tfpandroidbridge_pack.lpk (in "..../android_bridges" folder)
lazandroidwizardpack.lpk (in ""..../android_wizard" folder)
amw_ide_tools.lpk (in "..../ide_tools" folder)
Go to Infrastructure.

LAMW Manager (Linux and Windows)

Light bulb  Note: All in One! LAMW Manage produces a complete Lazarus for Android environment by automating the step Infrastructure!
Install * LAMW Manager Installer for Linux
Install * LAMW Manager Installer for Windows

Install LAMW using fpcupdeluxe (Linux and Windows)

How to install on Linux (FPCUPdeluxe + LAMW)
How to install on Windows (FPCUPdeluxe + LAMW)

Do It Yourself! (Windows)

Install * Lazarus 2.0.12
Light bulb  Note: Install here: "C:\lazarus2.0.12" (not "Program Files" !!!)
Install * LAMW
Light bulb  Note: Download LAMW and unzip it in some folder (ex. "C:\lazarus2.0.12\components")
Packages installations order/sequence:
tfpandroidbridge_pack.lpk (in "..../android_bridges" folder)
lazandroidwizardpack.lpk (in ""..../android_wizard" folder)
amw_ide_tools.lpk (in "..../ide_tools" folder)
Install * FPC source code (trunk)
Download FPC source code and unzip it in some folder and point up the source path in next step


Go to Lazarus menu "Tools" >> "[LAMW] Android Module Wizard" >> "Build FPC Cross Android"
Light bulb  Note: repeat the "Build and install" process once for each architecture
(x) Armv7a + Soft (android 32 bits << tested!)
Build
Install
(x) Aarch64 (android 64 bits << tested!)
Build
Install
Light bulb  Note: After "build" and "install" the cross-compilers and after to do all Infrastructure go to Using LAMW and try to create your first [New] LAMW project!
If you get an error "Fatal: Cannot find unit system used by fcllaz of package FCL" when trying "Run" >> "Build" your project then go to "fpc.cfg" (ex. "C:\lazarus2.0.12\fpc\3.2.0\bin") and:
change:
#searchpath for units and other system dependent things
-FuC:\lazarus2.0.12\fpc\$FPCVERSION/units/$fpctarget
-FuC:\lazarus2.0.12\fpc\$FPCVERSION/units/$fpctarget/*
-FuC:\lazarus2.0.12\fpc\$FPCVERSION/units/$fpctarget/rtl
to:
#searchpath for units and other system dependent things
-FuC:\lazarus2.0.12\fpc\3.2.0/units/$fpctarget
-FuC:\lazarus2.0.12\fpc\3.2.0/units/$fpctarget/*
-FuC:\lazarus2.0.12\fpc\3.2.0/units/$fpctarget/rtl


And go to Lazarus IDE menu "Tools" >> "Options" >> "Environment" >> [FPC Source]
change:
$(LazarusDir)fpc\$(FPCVer)\source
to:
$(LazarusDir)fpc\3.2.0\source


Infrastructure

Light bulb  Note: Only for non-users of LAMW Manager!

Get Java JDK

Install * Java JDK 8

Get Android NDK

Install * r19c

Get Ant builder

Install * Ant
Simply extract the zip file to a convenient location...

Get Gradle builder

Install * Gradle 6.6.1
Light bulb  Note: Use the option "extract here" to produce the folder "gradle-6.6.1" in a convenient location...

Get Android SDK

Install * r25.2.5-windows
Install * r25.2.5-linux
Install * r25.2.5-macosx
How to
unpacked/install to a "sdk" folder
open a command line terminal and go to folder "sdk/tools"
run the command >> "android update sdk" to open a GUI "SDK Manager"
Go to [Tools] and keep "as is"
Android SDK Tools (installed)
(x) Android SDK Platform-Tools
(x) Android SDK Build-Tools 29.0.3 (and others more recent)
Go to [Android R] and uncheck all!
Go to [Android 10 API 29] uncheck all and check only
(x)SDK Platform
Go to [Extras] and check:
(x)Android Support Repository
(x)Google USB Drive (Windows only...)
(x)Google Repository
(x)Google Play Services
[Install 7 package!]


Using LAMW

Configure Paths

Lazarus IDE menu "Tools" >> "[LAMW] Android Module Wizard" >> "Paths Settings ..."
Light bulb  Note: MacOs: path to Java JDK auto setting!

Create and Run your first Android Apk

How to
From Lazarus IDE select "Project" >> "New Project"
From displayed dialog select "[LAMW] GUI Android Module" and "Ok"
Fill the form/dialog fields and "Ok"
Light bulb  Note: Path to Workspace" is your projects folder
Light bulb  Note: Accept "default" options! (but pay attention to the * signage)
"Save" unit1 as/where suggested
Light bulb  Note: Search your project folder... you will find many treasures there! (look for lazarus project in ".../jni" folder)
From Lazarus IDE select "Run" >> "Build"
Success! Your system is up to produce your first Android Apk!


Configure your phone device to debug mode and plug it to the computer usb port


From Lazarus IDE select "Run" >> "[LAMW] Build Apk and Run"
Congratulations! You are now an Android Developer!

Other references

Tutorial: My First "Hello Word" App

Retrieved from "http://wiki.freepascal.org/index.php?title=LAMW&oldid=156488"