PSP 编程 教程01-02

课程01
建立开发环境
如何获得软件toolchain,PSPSDK以及如何通过CYGWIN在安装Windows操作系统的计算机上运行它们。以下是完整的新手教程。
这是该教程中使初学者掌握在Sony PSP上开发自制软件的第一部分。如果你正在阅读这部分内容，恭喜你，你已经克服了对于编程者来说的最大的障碍。或许编程最困难的就是开始。当然，通过阅读该教程学习之路会变的轻松。
建立开发环境是创建自制程序的第一步。此环境将你写的程序源代码转换为一个可以在PSP上运行的编译过的文件。我们将在系统中安装两个重要的工具。
第一个工具是CYGWIN。它是运行在Windows操作系统上的Linux仿真器。它能在你的计算机上创建一个模拟 Linux操作系统的环境来运行基于Linux的程序。听起来吓唬人，但是不要担心，它用起来很简单。
第二个工具是toolchain。它是开发PSP程序的关键。它能建立你需要的任何东西：头文件、库文件、编译器、示例程序。一旦安装好后，你便能准备创建你的第一个程序了。
安装：
第一步是安装CYGWIN。你能从http://www.cygwin.com/下载安装文件。下载完成后，运行该程序。你将看到一个窗口，点击next，选择默认”Install from Internet”，点击next。安装程序会询问你将把CYGWIN安装在哪里。如果路径没有设置成”c:/cygwin”，请更改安装路径为c:/cygwin（C:是你的本地磁盘）。保持其他选项默认，点击next。程序提示将把安装文件存放在哪里。你选择什么路径无所谓，但是我建议将他们放在某个你能找到地方，安装完后可以删除他们。一旦选择了合适的路径，点击next。下个窗口是设置网络，如果你不使用代理（或不知道什么是代理），只要点击next就可以了。如果没有效果的话，请退回并尝试使用Internet Explorer的设置。现在呈现在你面前的是下载文件的服务器列表。任何服务器都可以，选择一个，然后点击next。现在开始下载文件，根据你的连接速度将会花费一些时间。一旦完成，点击窗口顶部的view按钮察看将要安装的软件包。必须安装如下文件包：

l autoconf2.1
l automake1.9
l gcc
l gcc-g++
l make
l patchutils
l subversion
l wget

通过点击skip来选择他们，skip应该会变成一个版本号。不要担心别的包是否被选中；你选择的这些CYGWIN或别的包需要的包将会被自动安装。当你完成后点击next。CYGWIN将立即下载并安装选择的包。这很可能会花费一段时间，因此当你在等待的时候去看下电视或上网冲浪。安装完成后，准备安装toolchain。
现在，我们将开始把toolchain安装到CYGWIN的环境中。为了设置环境，我们需要先运行CYGWIN。因此，从开始菜单或”c:/cygwin”运行CYGWIN程序（cygwin.bat）。它将打开一个命令行窗口，当你看到”yourusername@yourcomputername~”后关闭该窗口；现在已经成功建立环境。从http://www.oopo.net/consoledev/下载toolchain，它在页面底部。下载该文件，完成后，用Winrar将里面的文件解压缩到”c:/cygwin/home/user”，user是你的用户名。
Toolchain需要一些设置为了能在CYGWIN下运行，运行记事本，打开”c:/cygwin/home/user/psptoolchain/toolchain.sh”执行查找和替换，将gmake替换成make，将gpatch替换成patch然后保存文件。现在开始安装，再次打开CYGWIN命令行。现在是时候介绍Linux的命令行了，你应该看到行首有一个”$”字符。这意味着你是在普通用户模式中运行命令行而相反的是root（或admin）模式，这在CYGWIN中不太重要，但是如果你曾经使用过真正的Linux命令行那就必须要注意。
现在需要将路径改为toolchain解压缩后的目录。在命令行窗口中输入ls显示当前目录下的所有文件（类似Windows命令行中的dir命令）。现在你应该看到一个名为psptoolchain的目录——这就是需要进入的目录，输入cd psptoolchain回车。Cd表示改变目录就是改变当前进行操作的目录。再次输入ls，你将会看到该目录下的文件。输入./toolchain.sh运行这个文件。在Linux中.表示当前目录，..表示父目录，因此该命令的意思是执行当前目录中的toolchain.sh，toolchain.sh脚本将为你处理余下的工作。依据电脑的配置，这会花费几小时。我的P4 3.0的电脑花费了大约3小时的时间，请耐心等待。
接下来是最后一步，我们必须告诉CYGWIN哪里能找到PSPSKD（刚才toolchain安装的部分）和toolchian。改变c:/cygwin中包含的路径。关闭CYGWIN，打开c:/cygwin右键cygwin.bat。选择Edit打开记事本按照如下所示进行更改：
@echo off

C:
chdir C:/cygwin/bin

bash --login -i

Change this to:

改成

@echo off

C:
chdir C:/cygwin/bin

set path=%path%;C:/cygwin/usr/local/pspdev/bin
set PSPSDK=C:/cygwin/usr/local/pspdev

bash --login -i
你已经准备好了，如果你有要编译的源代码，用cd命令进入该目录输入make你将会得到可以装入PSP的eboot.pbp文件。如果不会，请察看课程02学习怎样创建你自己的简单PSP程序。

课程2
创建你的第一个程序
在Sony PSP上安装、创建和执行简单的”Hello World”程序
阅读课程01后，你已经有了一个创建程序的开发环境。我们现在开始学习PSP上的第一个程序。该教程将解释C程序语言基础和创建PSP程序的基础。
创建一个目录来存放项目文件。打开CYGWIN命令行，输入mkdir projects。Mkdir表示创建目录该命令会在你当前的目录下创建一个目录或文件夹。这样我们就有一个存放项目文件的目录，输入cd projects进入该目录。现在将为指定的工程创建另一个目录。输入mkdir helloworld。输入cd helloword进入该目录。
下一步打开文本编辑器，可以是记事本、写字板等。我更喜欢使用专门编辑C/C++代码的编辑器因为它内建了语法加亮的功能（我使用Dev-C++），使用哪个文本编辑器都无所谓（只要你知道如何使用它）。
现在在你的helloworld目录中创建一个新文件main.c。这个文件中将包含程序代码。源代码就是人们能看懂的程序。大部分编程语言都叫作编译语言，C和C++都属于这一类（使用课程01讲的编译器转换源代码）。还有一些别的程序语言使用称作解释器的工具解释源代码并发送给运行中的电脑。这些语言称为脚本语言（例如PHP）。
我们有一个保存源代码的文件。现在开始编程。首先程序代码中应该包含能向阅读该程序的人说明程序功能、编写时间和作者的注释。注释是一行不会被编译器编译的代码（或是被脚本语言中的解释器忽略的语句）。注释在你的源代码中是非常重要的一部分，因为当你（或某人）以后看源代码的时候，你很难再回忆起整个程序的意思。因此必须通过注释的形式做纪录。使用//或/*进行注释。任何时候看到//都说明该行其余部分被注释。/*的意思是编译器（或解释器）将忽略该符号直到遇到*/中间的源代码。/*…*/能跨越多行，但是//只能注释//所在的一行。
好了，开始编写程序，我们将在开始部分输入一段能说明程序干什么、什么时候创建、谁写的注释。
/*
This program was created by (Your Name Here) on (Date Here)
It is a simple "Hello World" Application.
*/
程序的下一部分是告诉编译器程序中将用到哪些头文件（header files）和哪些包含文件（include files）。#include命令能将你在程序开始部分指定的文件内容复制进来。这能使你的程序变的简洁，当然你也可以使用前面写的代码。Include命令也能包含编译所需的头文件（或者是你为编译增加的命令），或者是项目中指定的头文件。这些文件会出现在<>中或引号中。小于号和大于号表示该文件存在于编译器的include目录中，引号包含的是和包含它们的文件处于同一个目录的文件。我们将在程序中包含2个文件。第一个是pspkernel.h。任何一个PSP程序中都要包含它。它包含了所有PSP的特殊代码。如果没有包含它那程序将无法在PSP上运行。第二个文件是pspdebug.h，这个文件包含了几个有用的方法用来调试你的程序，特别是其中包括了我们用来在PSP输出文本时用到的函数。在你的程序中加入这些代码：

#include <pspkernel.h>
#include <pspdebug.h>

下面我们告诉PSP一点关于该程序的信息。事实上这不太重要，你的程序不会编译它，但是通常加入它是个好注意。第一个属性是程序的名字，但事实上并不是发表的程序的名字（我们以后会更改）。别的值是另外的属性（让它们去），主要是版本，次要版本。维持默认的属性值。在程序中加入下面一行：

PSP_MODULE_INFO("Hello World", 0, 1, 1);

现在我们开始创建一个屏幕输出的函数。这个步骤是可选的，但是他能使程序输出文本变的容易些。行尾更改PSP内建的函数名（pspDebugScreenPrintf）为容易书写的函数名。这个函数用来将文本输出到屏幕上（以后会用到）。我们要做的就是将pspDebugScreenPrintf改成printf。现在开始就可以使用printf了，编译器会象pspDebugScreenPrintf一样处理。按照如下所示来定义：

#define printf pspDebugScreenPrintf

有个坏消息和好消息，坏消息是，下个代码块相当复杂。好消息是，你不需要理解它。下面大致解释一下（我们会在以后用现行的语法一行一行解释）。这个代码块包含的内容基本上叫做程序。这些函数将在你的PSP上建立功能并允许你想要退出时停止或退出游戏。将如下代码块写入你的程序：
/* Exit callback */
int exit_callback(int arg1, int arg2, void *common) {
sceKernelExitGame();
return 0;
}

/* Callback thread */
int CallbackThread(SceSize args, void *argp) {
int cbid;
cbid = sceKernelCreateCallback("Exit Callback", exit_callback, NULL);
sceKernelRegisterExitCallback(cbid);

sceKernelSleepThreadCB();

return 0;
}

/* Sets up the callback thread and returns its thread id */
int SetupCallbacks(void) {
int thid = 0;

thid = sceKernelCreateThread("update_thread", CallbackThread, 0x11, 0xFA0, 0, 0);
if(thid >= 0) {
sceKernelStartThread(thid, 0, 0);
}

return thid;
}
接下来定义main函数。每个C或C++程序必须要有一个主函数。函数从这里开始执行。C（一些C++）函数就是很好的例子。这意味着代码会顺序执行。例如下面的代码：

//不要将下面的代码输入到你的程序中。
//这只是一个例子。
int myFunction() {
//Print Out 'A'
return 0;
}
int main() {
//Print Out 'B'
myFunction();
//Print Out 'C'
return 0;
}
注释中的内容表达了他们的意思。程序会输出’B’然后再输出’A’因为程序是从main函数开始执行。输出’B’然后调用上面定义的myFunction函数，到这里，发现程序需要打印’A’然后返回离开主线的地方并且输出’C’。所有的程序（直到你接触到高级的C++语言）都遵循这种线性结构。Main函数对于你的程序是至关重要的。可以使用如下的结构定义一个函数：[return type] [function name](){。Return type是函数传递给主程序的值的类型。Main函数通常返回int类型（表示整数）。函数名是这个函数的名称，显而易见main就是main函数的名称。在你的代码中输入下面的内容来定义函数：

int main() {。

现在需要添加2行内容来建立输出屏幕并用那些前面插入的函数（你不需要知道他们是怎么工作的）。即使你不需要知道这些函数如何工作，但是掌握他们为什么叫做函数的概念是很重要的。事实上很简单。你只要在最后把函数名和括号一起输入进去就可以了（如果函数带有一些参数，就将他们插入到括号中，以后会用到）。程序中的任何一行最后都要输入一个分号。因为编译器无法辨别任何空白。两行之间可以有100行空白行，编辑器不会理会。这非常有用因为可以按你自己的要求安排代码格式。你可以将几行并为一行，或者在空白区域输入内容。但每行结尾都要有一个分号。在你的程序中添加2行：

pspDebugScreenInit();
SetupCallbacks();

现在写一些能看到结果的代码。记得我们将pspDebugScreenPrintf定义成printf。通过调用含有一个参数的printf函数在屏幕上打印文本（前面说以后会用到）。参数是一个能传递给函数使用的变量。当书写函数时这些必须掌握。为了printf能输出到屏幕，必须将一个字符串传递给它。通过传递给这个函数一个字符串，就能输出Hello World了。我们也能传递别的参数值，但是时间关系，现在只要输出Hello World到屏幕上：

printf("Hello World");

你已经告诉printf输出到屏幕。现在我们只要再做一些工作源代码就可以构建了。为了能看到输出结果需要暂停程序。如果不暂停，程序会冻结或返回PSP的菜单那样便无法得到输出到屏幕上的单词因为输出结果被迅速清除。加入该行代码停止程序直到按下Home按钮回到PSP的操作系统中。

sceKernelSleepThread();

接下来需要让程序返回一个值，当时定义过 int main()告诉编译器main函数将返回一个整数类型的值。因此就象如下所示返回一个0：

return 0;

最后输入一个}结束函数。
这就是程序！现在我们只要通过创建一个makefile告诉编译器需要编译该工程。创建一个没有扩展名的名为makefile的文件。一旦创建好，用文本编辑器打开它。在文件中输入如下内容：

TARGET = hello
OBJS = main.o

CFLAGS = -O2 -G0 -Wall
CXXFLAGS = $(CFLAGS) -fno-exceptions -fno-rtti
ASFLAGS = $(CFLAGS)

EXTRA_TARGETS = EBOOT.PBP
PSP_EBOOT_TITLE = Hello World

PSPSDK=$(shell psp-config --pspsdk-path)
include $(PSPSDK)/lib/build.mak

你的所有的简单工程都能以该文件作为基础来创建。有时需要增加库或该makefile文件中没有的内容，但现在还相当简单。它告诉编译器取得main.c并使用PSPSDK将该文件构建为一个PSP能读取的.pbp文件。如果在别的工程中使用这个makefile文件你需要更改PSP_EBOOT_TITLE=Hello World。将Hello World改为你的程序的名称，当你选中该文件此名称会在你的PSP中的Game Menu中显示。
打开CYGWIN命令行菜单进入projects/helloworld目录。输入make，CYGWIN会输出一些数据告诉你源代码是否包含错误导致无法编译。通常警告信息不必太留意，必须注意的是错误，警告只不过是会导致错误的地方。
如果没有任何错误，恭喜！现在已经成功地创建并编译了你的第一个PSP程序。我打赌你现在很想测试它。那么，象存放别的一些自制程序一样将C:/cygwin/home/yourUserName/projects/helloworld/EBOOT.PBP存入你的PSP中自己测试！
课程03将学习更多关于PSP编程的内容，诸如语句，变量，循环和按键输入。