Contents[hide]
|
本文是Documentation/Maemo 5 Final SDK Installation的简体中文翻译。
以下文档介绍了如何安装Maemo 5 Final SDK。Maemo SDK使用Scratchbox作为交叉编译环境,你还需要安装Maemo的开发文件。
在开始安装以前,先来看一下最小的系统需求。官方支持基于Debian的x86-32 Linux发行版,主要是Debian和Ubuntu。但在其他Linux发行版上安装Maemo SDK也是可以做到的。
当你确定你的开发设备符合这些要求后,你可以按照以下指南操作。
Maemo 5 SDK配备了两个命令行安装脚本,以及一个附带图形界面的安装程序(仍是beta版本),以简化SDK的安装。
Maemo 5 SDK通过一个需要认证的软件源,提供了开发者所需要的Nokia二进制开发文件包,以及附带的Nokia应用程序。为了获取这些文件,你需要接受 Nokia的最终用户许可协议。为了获得Maemo SDK的完整功能,你需要这些开源工具包以外的Nokia二进制文件包。
在你的主机上执行Maemo SDK程序需要Xephye这个X11服务器。这个X11服务器提供了一个窗口,显示设备屏幕和用户界面,使得开发者可以在自己的主机上看到Maemo程序窗口和界面。这个软件没有包含在Maemo SDK内,因为绝大多数Linux发行版都提供了这个软件。
如果你在基于Debian的Linux发行版上,通过图形界面的安装程序安装Maemo SDK,将为你提供安装Xephyr的选项。
如果不是,你可以采用以下的方式,手工安装Xephyr。
在基于Debian的Linux系统上,可以在Scratchbox环境外,以root权限,使用apt-get安装Xephyr。
$ sudo apt-get install xserver-xephyr
在Gentoo系统上,你需要添加kdrive这个useflag,再编译xorg-server,以获得Xephye。
现在,Maemo 5 SDK拥有了使用方便的图形界面安装方式。这个安装程序可以在基于Debian的发行版上安装Scratchbox和Maemo 5 SDK。同时,也可以处理这个页面提供的Nokia最终用户协议,并安装Nokia的二进制开发工具包和应用程序。
图形界面安装程序拥有以下功能。
图形界面安装程序提供了标准安装和自定义安装两种选择。标准安装使用默认设置,而自定义安装提供了更多的选择。需要注意的是,如果存在 FREMANTLE_X86和FREMANTLE_ARMEL的编译目标,标准安装将会覆盖这两个目标,不过Scratchbox的home目录将会被保留。如果你不想覆盖这两个编译目标,请使用自定义安装。
安装程序是一个python Qt程序,需要pyQt的支持。如果你的系统没有安装这些软件包,安装程序可以安装他们。
如果有需要,安装程序可以使用http代理。如果你的网络连接没有正常工作,安装程序将请求你手工设置代理。
安装程序在Ubuntu Karmic和Debian Lenny上经受了测试,32位和64位版本都可以正常使用。安装程序需要下载Maemo SDK,因此你需要一个可用的互联网连接。
开始安装
如果你要在一个非Debian系统上执行安装脚本,可能会缺少一些python的设置,从而无法自动定位scratchbox的安装路径。为了解决这个问题,你需要给这个脚本打一个补丁
以下是补丁文件。
129c129 < SB_PATH = "/scratchbox" --- > SB_PATH = "/opt/scratchbox" 2297a2298 > opt = opt + "-s /opt/scratchbox" 2351a2353 > cmd = cmd +" -s /opt/scratchbox"
另外,你也应该去除安装Xephyr的选项,然后手工安装它。
使用wget下载安装程序。
$ wget http://repository.maemo.org/stable/5.0/maemo-sdk-install-wizard_5.0.py
为安装程序添加可执行权限
$ chmod a+x maemo-sdk-install-wizard_5.0.py
安装需要root权限。
Ubuntu $ sudo ./maemo-sdk-install-wizard_5.0.py
Debian $ su -c ./maemo-sdk-install-wizard_5.0.py
注意:
1. 下载Scratchbox和Maemo SDK的安装脚本。你也可以在Nokia开发论坛(Maemo SDK at Forum Nokia)上下载到同样的脚本。
$ wget http://repository.maemo.org/stable/5.0/maemo-scratchbox-install_5.0.sh http://repository.maemo.org/stable/5.0/maemo-sdk-install_5.0.sh
2. 为脚本添加可执行权限。
$ chmod a+x ./maemo-scratchbox-install_5.0.sh ./maemo-sdk-install_5.0.sh
3. 以root权限运行Scratchbox安装脚本,同时指定需要添加到Scratchbox用户组的用户。该用户必须是宿主Linux系统中有效的用户。这将下载大约420MB的内容,不支持断点续传。
$ sudo ./maemo-scratchbox-install_5.0.sh -u USER
4. 安装脚本将会在“sbox”用户组中添加指定的用户。要使改设置在当前终端进程中生效,你需要执行以下命令。
$ newgrp sbox
5. 这时,你已经获得了一个可用的Scratchbox环境。
6. 继续进行Maemo SDK的安装。这个脚本需要在Scratchbox环境外,以安装时指定的用户权限运行。首先,为脚本用户添加可执行权限。
$ sudo chmod +x ./maemo-sdk-install_5.0.sh
然后运行。
$ ./maemo-sdk-install_5.0.sh
如果你将Scratchbox安装到了/scratchbox以外的目录,你需要用“-s PATH”选项来指定你的Scratchbox目录。你可以使用“--help”选项获得更多的命令行选项信息。
7. 脚本成功执行完成后,你就可以登录Scratchbox环境了。
$ /scratchbox/login
如果你无法登录,请看一下Scratchbox的问题。
8. 你需要接受Nokia的最终用户许可协议,才能够获取Nokia提供的二进制软件包。安装这些软件包后,你将会获得Maemo SDK的完整功能。
8.1. 通过这个页面,接受最终用户许可协议。
8.2. 将接受最终用户许可协议后获得的软件源地址,分别添加到x86和armel两个编译目标环境的/etc/apt/source.list文件中。在两个目标环境下,分别执行以下命令。
[sbox-FREMANTLE_X86: ~] > sb-conf select FREMANTLE_ARMEL [sbox-FREMANTLE_ARMEL: ~] > nano /etc/apt/sources.list # 添加软件源地址 [sbox-FREMANTLE_ARMEL: ~] > apt-get update [sbox-FREMANTLE_ARMEL: ~] > fakeroot apt-get install nokia-binaries nokia-apps [sbox-FREMANTLE_ARMEL: ~] > sb-conf select FREMANTLE_X86 [sbox-FREMANTLE_X86: ~] > nano /etc/apt/sources.list # 添加软件源地址 [sbox-FREMANTLE_X86: ~] > apt-get update [sbox-FREMANTLE_X86: ~] > fakeroot apt-get install nokia-binaries nokia-apps
以上步骤将安装Nokia的二进制文件包,一些开源工具包依赖它们。这样,你就完成了Maemo 5 SDK开发环境的配置,可以动手进行开发了。
这是来自opensuse.org的安装指南。
在启动用户界面前,请先确认你已正确安装了以下内容:
1. 首先,在Scratchbox环境外,启动Xephyr:
Xephyr :2 -host-cursor -screen 800x480x16 -dpi 96 -ac -kb &
2. 登录Scratchbox的X86编译目标环境
$ /scratchbox/login Welcome to Scratchbox, the cross-compilation toolkit! Use 'sb-menu' to change your compilation target. See /scratchbox/doc/ for documentation. [sbox-FREMANTLE_X86: ~]>
3. 设置DISPLAY环境变量,使之与Xephyr的设置相符。
[sbox-FREMANTLE_X86: ~] >export DISPLAY=:2
4. 启动用户界面。
[sbox-FREMANTLE_X86: ~] >af-sb-init.sh start
5. 图形界面将出现在Xephyr窗口中。
6. 你可以用如下命令终止用户界面:
[sbox-FREMANTLE_X86: ~] >af-sb-init.sh stop
由于Scratchbox只支持x86-32架构的linux宿主系统,因此,在x86-64系统中,我们需要强制安装x86-32的Scratchbox软件包。在执行Scratchbox的安装脚本时,添加“-F”选项即可。
安装流程
$ wget -c http://repository.maemo.org/stable/5.0/maemo-scratchbox-install_5.0.sh http://repository.maemo.org/stable/5.0/maemo-sdk-install_5.0.sh
$ chmod a+x ./maemo-scratchbox-install_5.0.sh ./maemo-sdk-install_5.0.sh
$ sudo ./maemo-scratchbox-install_5.0.sh -F -u $USER
在成功安装Scratchbox后,请参照x86-32系统的安装指南,继续安装Maemo 5 Final SDK。
如果通过Debian的deb包安装了Scratchbox,Scratchbox的启动脚本/etc/init.d/scratchbox-core将被正确安装,Scratchbox也会在系统重启时自动启动。
如果你通过tarballs的方式安装了Scratchbox,那么当系统重启后,Scratchbox需要的挂载配置和binfmt_misc都将被清除。
要使Scratchbox在重启后继续工作,你需要以root权限执行以下命令:
$ sudo /scratchbox/sbin/sbox_ctl start
此外,你也可以将sbox_ctl作为一个系统脚本,添加到/etc/init.d目录下,并在对应的运行等级目录中创建链接。在大多数系统中,方法如下:
$ ln -s /scratchbox/sbin/sbox_ctl /etc/init.d/scratchbox-core $ /usr/sbin/update-rc.d scratchbox-core defaults
请查阅你的系统文档,以了解相应的方法。
不幸的是,从Beta 2平滑地升级到Final SDK是不可能的。因此我们建议你重新安装Final SDK。在你操作以前,请先看一下下列指引。
一些随Final SDK附带的Nokia应用程序使用了固定的路径,来指定用户的home目录。为了使这些程序能够正常工作,你需要创建一个目录,路径与Nokia指定的路径相同。
这需要在Scratchbox环境外,以root权限操作。
Scratchbox安装脚本的“-u”选项将更新环境并创建必要的链接。
执行以下命令,为已有的Scratchbox用户创建必要的链接。
$ sudo ./maemo-scratchbox-install_5.0.sh -u <EXISTING_USER>
此外,你也可以手动创建链接。如果Scratchbox被安装在了默认路径下,那么命令如下:
$ sudo ln -s /scratchbox/users/<username>/home/<username> /scratchbox/users/<username>/home/user
Final SDK的安装脚本也在/target/<target_name>/目录下添加了/opt目录。
为了便于在/opt路径下安装应用程序,一些linux系统会创建一个指向/home/opt的链接作为/opt目录。SDK也继承了这一特性。
在Scratchbox环境下,/opt目录的路径是/target/<target_name>/opt。
安装基本系统包rootstraps后,所有编译目标环境的/target/<target_name>/opt都将被指向/home/opt。而/opt应该为每个编译目标环境分别指定。
为了解决这个问题,我们需要手工检查/target/<target_name>/opt是否被链接了,如果是,那么删除这个链接,并且重新创建相应的目录。
事实上,由于API的变动,我们无法从Diablo升级到Fremantle。不过我们可以利用Diablo的Scratchbox环境,帮助配置Fremantle的Scratchbox环境。
所以,我们可以升级Scratchbox。
$ chmod a+x ./maemo-scratchbox-install_5.0.sh
$ sudo ./maemo-scratchbox-install_5.0.sh -U -u <EXISTING_USER> -s /scratchbox
当脚本执行成功后,继续进行Maemo 5 Final SDK的安装。
deb http://scratchbox.org/debian/ maemo5-sdk main
$ sudo apt-get update $ sudo apt-get install scratchbox-core scratchbox-libs scratchbox-devkit-qemu scratchbox-devkit-debian scratchbox-devkit-doctools scratchbox-devkit-perl scratchbox-toolchain-host-gcc scratchbox-toolchain-cs2007q3-glibc2.5-arm7 scratchbox-toolchain-cs2007q3-glibc2.5-i486 scratchbox-devkit-svn scratchbox-devkit-git scratchbox-devkit-apt-https
$ sudo dpkg -i --force-architecture scratchbox-core scratchbox-libs scratchbox-devkit-qemu scratchbox-devkit-debian scratchbox-devkit-doctools scratchbox-devkit-perl scratchbox-toolchain-host-gcc scratchbox-toolchain-cs2007q3-glibc2.5-arm7 scratchbox-toolchain-cs2007q3-glibc2.5-i486 scratchbox-devkit-svn scratchbox-devkit-git scratchbox-devkit-apt-https
$ sudo /scratchbox/sbin/sbox_adduser USER yes
$ sudo ln -s /scratchbox/users/<username>/home/<username> /scratchbox/users/<username>/home/user
$ newgrp sbox
$ /scratchbox/login
[sbox->:~]>sb-conf st FREMANTLE_X86 -c cs2007q3-glibc2.5-i486 -d perl:debian-etch:doctools:svn:git -t none [sbox->:~]>sb-conf st FREMANTLE_ARMEL -c cs2007q3-glibc2.5-arm7 -d qemu:perl:debian-etch:doctools:svn:git -t qemu-arm-sb
[sbox->:~]> wget http://repository.maemo.org/stable/5.0/armel/maemo-sdk-rootstrap_5.0_armel.tgz http://repository.maemo.org/stable/5.0/i386/maemo-sdk-rootstrap_5.0_i386.tgz
[sbox->:~]> sb-conf se FREMANTLE_X86 [sbox-FREMANTLE_X86: ~] > sb-conf rs maemo-sdk-rootstrap_5.0_i386.tgz
[sbox-FREMANTLE_X86: ~] > echo 'Acquire::http::Pipeline-Depth "0";' >> /etc/apt/apt.conf.d/00maemo
[sbox-FREMANTLE_X86: ~] > sb-conf in -edFL [sbox-FREMANTLE_X86: ~] > apt-get update [sbox-FREMANTLE_X86: ~] > fakeroot apt-get install maemo-sdk-debug
[sbox-FREMANTLE_X86: ~] >apt-get update [sbox-FREMANTLE_X86: ~] >fakeroot apt-get install nokia-binaries nokia-apps
[sbox-FREMANTLE_X86: ~] >rm /targets/FREMANTLE_X86/opt [sbox-FREMANTLE_X86: ~] >mkdir /targets/FREMANTLE_X86/opt
[sbox-FREMANTLE_X86: ~]> sb-conf se FREMANTLE_ARMEL [sbox-FREMANTLE_ARMEL: ~] > sb-conf rs maemo-sdk-rootstrap_5.0_armel.tgz
[sbox-FREMANTLE_X86: ~] > echo 'Acquire::http::Pipeline-Depth "0";' >> /etc/apt/apt.conf.d/00maemo
[sbox-FREMANTLE_ARMEL: ~] > sb-conf in -edFL [sbox-FREMANTLE_ARMEL: ~] > apt-get update [sbox-FREMANTLE_ARMEL: ~] > fakeroot apt-get install maemo-sdk-debug
[sbox-FREMANTLE_ARMEL: ~] >apt-get update [sbox-FREMANTLE_ARMEL: ~] >fakeroot apt-get install nokia-binaries nokia-apps
[sbox-FREMANTLE_ARMEL: ~] >rm /targets/FREMANTLE_ARMEL/opt [sbox-FREMANTLE_ARMEL: ~] >mkdir /targets/FREMANTLE_ARMEL/opt
好了,你现在获得了一个可用的Maemo 5开发环境。
下面可以启动用户界面了
首先,确认没有任何进程运行在Scratchbox环境中。 请先备份你需要的文件和目录。卸载Scratchbox会删除所有Scratchbox环境中的所有东西。
在基于Debian的系统中,以root权限执行以下命令:
$ sudo apt-get remove scratchbox-* --purge $ sudo rm -rf /scratchbox
在非Debian的系统中,你需要手工停止Scratchbox进程,然后删除它:
$ sudo /scratchbox/sbin/sbox_ctl stop $ sudo rm -rf /scratchbox
你需要注意以下这些Scratchbox的问题:
当宿主机内核开启了VDSO后,Scratchbox无法正常工作。我们正在努力解决这个问题。
如果你的宿主机开启了VDSO32,在登录Scratchbox时会出现这样的错误:
No directory, logging in with HOME=/ Inconsistency detected by ld.so: rtld.c: 1192: dl_main: Assertion `(void *)
ph->p_vaddr == _rtld_local._dl_sysinfo_dso' failed!
在2.6.25版本以后的x86-64内核中,默认启用了VDSO32。执行以下命令可以暂时禁用该特性:
sysctl abi.vsyscall32=0
如果你的内核版本低于2.6.24,你可以执行:
sysctl vm.vdso_enabled=0
或者
sysctl kernel.vdso=0
sysctl可以配置VDSO32,只有0或2的取值与Scratchbox兼容。在我们的例子中使用0(禁用)。2将启用compat模式。
你也可以将以下内容添加到/etc/sysctl.conf文件中
vm.vdso_enabled = 0 abi.vsyscall32 = 0 kernel.vdso = 0
保存并执行:
$ sudo sysctl -p
需要注意的是,这三行配置中,具体哪一行正确取决与你的Linux内核版本。当你执行“sysctl -p”时可能会出现“unknown keys”的警告。你可以忽略这些警告,三行配置中只有正确的那个会被启用。
警告:在把这些内容添加到sysctl.conf前,你应该尝试用echo配置他们,看看是否会引起一些特殊的问题。例如,在Ubuntu Gutsy中,曾经出现过VDSO的错误设置损害了系统,导致系统无法启动的情况。
WARNING : You should try setting these values by echoing them to the given locations before adding them to sysctl.conf to see if they cause any problems. For example, in some Ubuntu Gutsy installations, it has been observed that changing the VDSO settings will hang the system and thus making permanent changes in sysctl.conf may, in these cases, make your system unbootable.
(译者:该警告我没有把握正确翻译,故而保留原文。)