fill_config_ini

填写服务器 config.xml 文件

服务器配置需要一个简单的说明，用于填写语盒中间服务器访问的邮箱服务器地址、用户、密码等等。这个说明存放在config.xml 文件里面。注意如下事项：

请用 notepad++ UltraEdit 等兼容UTF-8格式的文本编辑器编辑、保存Config.xml文件，不然程序会解析出错
这个配置文件是利用xml配置的，xml是一种标记语言，语法很简单，不会的自己可以google一下，例如这样。
所有的** “是否”** 选项都是填写1为“是”，0或者其他值为否。
密码字段包涵 & < > " ' 分别替换成 & < > " ' 。因为xml的字符串字段解析的时候无法处理上述字符，详情见XML转义字符。
以下是初始配置，如果之后有删减，增加，可能没有及时更新，请以下载之后的服务器包中的config.xml文件为准。

主配置字段说明

<Yuchberry	
userPassword="111111"	
serverPort="9716"
	pushInterval="10"
	userSSL="0"
	convertoSimpleChar="0">

userPassword（用户密码）

用户密码。这个密码不是邮箱密码，建议不要和邮箱密码一样，用于认证推送客户端。这个密码也必须和SSL生成证书的密码一样，yuchberry SSL配置请看这里。例如 userPassword=111111

serverPort（主机端口）

yuchberry server 监听端口,负责与手机端通讯，推送服务器。在客户端的设置需要用到他。例如 serverPort=9716

pushInterval（推送间隔）

语盒中间服务器到邮件服务器上取信间隔，单位为秒，间隔越小，服务器占用资源越多。但是Push 到客户端的延迟也就越小。最小值为1。例如 pushInterval=10。对于有些邮箱来说，有一定的安全性，所以过短的间隔会导致邮箱锁定，IMAP/POP3方式无法访问，需要去手动解锁

userSSL（语盒客户端是否使用SSL来连接服务器）

是否使用自己生成的SSL证书进行推送。这个选项如果为1，则表示需要，为0或者其他值，表示不许要。SSL具体配置（生成证书，配置客户端等）看这里。例如 userSSL=0

convertoSimpleChar（简体转换繁体）

是否将服务器所有的字符串转换成简体。由于黑莓上的字体无法混用，所以使用简体中文的朋友显示不了繁体中文，索性，用服务器将其转换成简体，发送到手机上。

disableLog（禁止输出log日志）

用于表示是否禁用log日志的输出，默认是关闭的（就是可以输出日志的）。

disableReport（禁止发送统计数据）

语盒由于需要更好的开发产品，用户在使用的过程中，可能需要中间服务器发送统计数据给语盒官方服务器，如果将其写为 1 就是禁止发送这个统计数据。默认是发送的。这个统计信息绝对不会涉及用户隐私（包括密码，信件、微博、聊天内容等等），只有数量和容量。请你相信语盒开发者们，能够开发出更好的推送软件。

yc_port（语电通同步）

关于 yc*port 、yc_AccessToken、yc_RefreshToken 的说明，详细见这里。

Email账户配置说明

<EmailAccount
		account="[email protected]"
		password=""
		sendName="语盒"
		signinName=""

		useFullNameSignIn="0"
		
		protocol="imaps"
		host="imap.gmail.com"
		port="993"
		
		protocol_send="smtp"
		host_send="smtp.gmail.com"
		port_send="587"
		
		appendHTML="0"
	/>

account（帐户名称）

完整账户名称，也就是需要推送的邮箱地址，例如[email protected]。不能填写yuchberry，如果填写错误，比如[email protected]，是可以收到信件，但是发送不出去。

protocol（邮局连接协议）

用于接收邮件的协议，有如下选择 pop3 pop3s imap imaps ，带s的是用于 SSL 安全链接，例如 protocol=imaps 需要邮件服务器的支持，Gmail 配置如下图，其他邮箱不一而同。

[]

sendName（发送者名字）

如果你不想自己发送的时候别人收到的是赤裸裸的邮件地址的话，可以将其填上你希望别人看到的名字。例如 "语盒"

signinName（登录邮箱的登录名，大多数留空即可）

绝大部分情况留空即可。一般来说，登录名与邮箱地址都有关系，邮箱地址为[email protected] 那么登录名就是 yuchberry 或者是 [email protected] ，这个格式可以通过 useFullNameSignIn 进行控制，但是如果你的登录名为 [email protected] 那就必须通过这个字段控制了。如果这个字段非空，那么服务器就会使用这个字段的值登录邮箱，收发邮件。

host（邮局取信主机地址）

邮件服务主机地址。例如 host=imap.gmail.com

port（邮局取信主机端口）

邮件服务端口号。例如 port=993

password（帐户密码）

邮箱密码，当然这个谁都不应该忘记。例如 password=123456

cryptPassword（加密后的密码）

password 填写的密码明文，无法保证在服务器被黑之后的密码安全，于是就增加一个加密过后的密码字段，详细的配置在这里。

useFullNameSignIn（是否使用全地址登录）

是否利用全地址登录邮箱。有些邮箱需要用全地址[email protected] 而不是xxxx作为用户名称。例如hotmail，谷歌企业邮箱、foxmail（因为使用的是pop.qq.com）、vip.qq.com等等，就貌似需要全地址登录。

protocol_send（发送邮件协议）

发送邮件使用的协议，几乎都是smtp。例如 protocol_send=smtp

host_send（发送邮件连接的邮局主机）

发送邮件的主机地址。例如 host_send=smtp.gmail.com

port_send（发送邮件连接的邮局主机端口）

发送邮件的主机端口。例如 port_send=587

以上属性配置具体参考邮件系统的帮助。比如gmail的就在这里，具体的IMAP配置在这里，POP3在这里。

appendHTML（是否将HTML邮件转化成纯文本，附加在正文后面）

是否将HTML 转化成纯文本，并且跟随在正文的后面。这个选项有点古怪，但是如果你邮箱订阅的有谷歌咨询，而且用手机的自带HTML查看器打不开手机浏览器的话，就会需要这个功能了。

pushHistoryMsg （是否推送历史消息）

每当字段对于POP3协议来说，最好不要选择，因为无法标记POP3的信件为已读信件，所以会在每次重启服务器的时候把很多收过的信件推送过来。IMAP可以选择这个为 1 ，默认值为 0。

推送多个邮箱

如果想推送多个邮箱，就填写多个

<EmailAccount />

tag，这样就可以顺序推送了，第一个邮箱是发邮件的默认邮箱。回复邮件使用的是发送者发送的邮箱地址，而转发和新邮件发送，都是默认使用第一个邮箱发送。如果想推送两个邮箱，那么config.xml就会看起来像下面：

<Yuchberry	userPassword="520530"	serverPort="9716"	pushInterval="10"	userSSL="1"	convertoSimpleChar="1"	>
	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imaps"
		host="imap.gmail.com"
		port="993"
		
		protocol_send="smtp"
		host_send="smtp.gmail.com"
		port_send="587"
		
		appendHTML="1"
	/>
	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imaps"
		host="imap.gmail.com"
		port="993"
		
		protocol_send="smtp"
		host_send="smtp.gmail.com"
		port_send="587"
		
		appendHTML="0"
	/>
</Yuchberry>

如果有多个邮件帐户，在客户端新建发送邮件的时候，需要一个默认邮箱来发送，可以在客户端的高级设置里面进行配置。回复、转发则是使用的对应邮箱帐户。

各个邮箱的配置模版

gmail.com

	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imaps"
		host="imap.gmail.com"
		port="993"
		
		protocol_send="smtp"
		host_send="smtp.gmail.com"
		port_send="587"
		
		appendHTML="0"
	/>

163 网易

	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imap"
		host="imap.163.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.163.com"
		port_send="25"
		
		appendHTML="0"
	/>

vip.163

	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imap"
		host="imap.vip.163.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.vip.163.com"
		port_send="25"
		
		appendHTML="0"
	/>

126

	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imap"
		host="imap.126.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.126.com"
		port_send="25"
		
		appendHTML="0"
	/>

QQ

QQ 邮箱存在着很多不稳定因素，如果失败，需要等等再同步。
请使用浏览器访问QQ邮箱，确保其pop3/imap选项已经打开 [查看帮助](http://service.mail.qq.com/cgi-bin/help?subtype=1&id=26&no=308\)

	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imap"
		host="imap.qq.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.qq.com"
		port_send="25"
		
		appendHTML="0"
	/>

vip QQ

QQ 邮箱存在着很多不稳定因素，有的时候同步不上，需要等等再同步。注意：useFullNameSignIn="1"
请使用浏览器访问QQ邮箱，确保其pop3/imap选项已经打开 [查看帮助](http://service.mail.qq.com/cgi-bin/help?subtype=1&id=26&no=308\)

	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="1"
		
		protocol="imap"
		host="imap.qq.com"
		port="143"
		
		protocol_send="smtp"
		host_send="smtp.qq.com"
		port_send="25"
		
		appendHTML="0"
	/>

yahoo.com

	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="imaps"
		host="apple.imap.mail.yahoo.com"
		port="993"
		
		protocol_send="smtp"
		host_send="apple.smtp.mail.yahoo.com"
		port_send="587"
		
		appendHTML="0"
	/>

yahoo.com.cn

465 端口可能会连接失败。
雅虎邮箱免费版貌似不支持pop的链接，请确认可以在web界面配置pop选项查看帮助

	<EmailAccount
		account="[email protected]"
		password=""
		
		useFullNameSignIn="0"
		
		protocol="pop3"
		host="pop.mail.yahoo.com.cn"
		port="110"
		
		protocol_send="smtp"
		host_send="smtp.mail.yahoo.com.cn"
		port_send="25"
		
		appendHTML="0"
	/>

yahoo.cn