Editing Template.xml

Jump to navigation Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
[[Category:Software]]<noinclude>[[Category:Main]]</noinclude>
template.xml files are stored in '''sce_sys/livearea/content''' and are responsible for the livearea's design and functions of a Game/Application. Once a new game/app has been installed and the bubble launched for the first time, the content of the xml file will be partially written in the '''ur0:shell/db/app.db''' ''(tbl_livearea & tbl_livearea_frame)''
 
<div style="float:right">[[File:Xml-logo.png|100px|left]]</div>
 
<div style="color: #ffffff; background-color: #786D6C; border: 1px solid #808000; padding: 5px; {{box-shadow|4px|4px|8px|#b0b090}}">
template.xml files are stored in '''sce_sys/livearea/content''' and are responsible for the livearea's design and functions of a Game/Application. Once a new app has been installed and the bubble is launched for the first time, the xml's content will be partially written in the '''ur0:shell/db/app.db''' ''(tbl_livearea & tbl_livearea_frame)''
</div>
 
==Sample of a basic xml structure==
<!-- syntaxhighlight not working for now -->
 
{{Boxcode|>
 
<pre><?xml version="1.0" encoding="utf-8"?>
 
<livearea style="a1" format-ver="01.00" content-rev="1">
  <livearea-background>
    <image>bg0.png</image>
  </livearea-background>
  <gate>
    <startup-image>startup.png</startup-image>
  </gate>
 
  <frame id="frame3">
    <liveitem>
      <text><str>Hello World!</str></text>
    </liveitem>
  </frame>
</livearea></pre>
}}
 
Inside the '''<livearea>'''-tag the basic layout will be declared along with some internal version information of the xml.
 
In the '''<image>-tag''' inside the '''<livearea-background>'''-tag the background picture will be declared ''(by default this will be bg0.png and located next to the template.xml itself)''
 
Analog to this the '''<startup-image>'''-tag inside the '''<gate>'''-tag declares the startup icon. ''(startup.png by default)''
 
And lastly the string "Hello World!" will be displayed at the position of frame3 depending on the livearea style.
 
 
==Tags==
 
===<livearea>===
'''Example:'''
<pre><livearea style="a1" format-ver="01.00" content-rev="1"></pre>
Different Layouts for ''style=""'':
<gallery>
Frames layout a1.jpg|a1
Frames layout a2.jpg|a2
Frames layout a3.jpg|a3
Frames layout a4.jpg|a4
Frames layout a5.jpg|a5
Frames layout ad0.jpg|ad0
[https://www.psdevwiki.com/vita/File:VLvcCUf.png]|ad1
[https://www.psdevwiki.com/vita/File:ovUfSii.png]|ad2
[https://www.psdevwiki.com/vita/File:TfduneH.png]|ad3
[https://www.psdevwiki.com/vita/File:3mcKIa4.png]|ad4
Frames layout nsx1.jpg|nsx1
Frames layout ps1emu.jpg|ps1emu
Frames layout psmobile.jpg|psmobile
Frames layout pspemu.jpg|pspemu
Frames layout vd.jpg|vd
Frames layout browser.jpg|browser
Frames layout content_manager.jpg|content_manager
Frames layout kids.jpg|kids
Frames layout music.jpg|music
</gallery>
 
===<livearea-background>===
<pre><livearea-background>
  <image>bg0.png</image>
</livearea-background></pre>
 
===<gate>===
 
 
===<startup-image>===
Example:
<pre><gate>
  <startup-image>startup.png</startup-image>
</gate></pre>
 
===<frame>===
Depending on the layout style, there will be different numbers of frames available. The positions itself are fix but you can position your liveitems inside them freely.
<pre><frame id="frame3" multi="o" autoflip="0" rev="1"></pre>
 
===<liveitem>===
Liveitems are the actual displayed 'widgets' inside a frame. There can be different versions for different; language settings, time settings, age limits or even device models!
<pre><liveitem default="on"></pre>
<pre><liveitem from="2016-07-25T07:00:00.00Z" until="9999-07-25T17:00:00.00Z"></pre>
 
===<text>===
Example for styling options:
<pre><text align="outside-right" ellipsis="off" line-align="left" line-break="on" line-space="3" margin-left="39" margin-top="18" origin="image" pre-br="on"  text-valign="center" valign="bottom" word-scroll="off" word-wrap="on" x="17" ></pre>
 
===<str>===
Example for styling options:
<pre><str bold="on" color="#ffffff" emboss="off" oblique="off" shadow="off" size="22.000000" underline="off">Lorem Ipsum</str></pre>
 
===<image>===
Example for styling options:
<pre><image align="center" origin="frame" valign="top" width="99" height="99" x="-209">x.png</image></pre>
 
===<background>===
<pre><background align="center" valign="center" >x.png</background></pre>
 
===<target>===
Creates a link that can be selected and touched. Can open a website or execute an uri call.
Examples:
<pre><target>http://xyz.com</target></pre>
<pre><target>camera:</target></pre>
<pre><target>psns:browse?product=EP4293-PCSB00956_00-GALGUNWAPP000000</target></pre>
 
 
===<lang>===
Example: The liveitem containing this tag will only become active if the Vita's language setting is set to Japanese.
<pre><lang>ja</lang></pre>
'''Language Codes:''' ja, en, fr, es, de, it, nl, pt, ru, ko, ch, zh, fi, sv, da, no, pl, en-gb, pt-br, tr
 
See [[Languages]] page.
 
===<exclude-lang>===
The liveitem will become active if the Vita's language setting doesn't match the language code(s). ''(Multiple declarations possible!)''
<pre><exclude-lang>en-gb</exclude-lang>
<exclude-lang>fr</exclude-lang>
<exclude-lang>es</exclude-lang>
<exclude-lang>de</exclude-lang></pre>
 
===<age-limit>===
<pre><age-limit >3</age-limit></pre>
 
===<model>===
The liveitem will only become active on a Vita.
<pre><model>vita</model></pre>
 
 
==Advanced tags for System Applications==
 
<pre><title color="#000000ff"/></pre>
Sets the title color for system apps in the top left corner.
 
<pre><system-function-zone>
  <func>voucher-code</func>
  <func>online-manual
    <target>sceman:photos</target>
  </func>
  <func>reload</func>
</system-function-zone></pre>
Declares additional buttons to the top of the livearea screen.
 
==Frame Example of NPXS10015==
[[File:Frame settings.png]]
 
You can always dump the un-encrypted template.xml of any System application from '''vs0:app/NPXS1????/sce_sys/livearea/contents/''' or any installed game/app from '''ur0:appmeta/TitleID/livearea/contents/'''.
Please note that all contributions to Vita Developer wiki are considered to be released under the GNU Free Documentation License 1.2 (see Vita Developer wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following hCaptcha:

Cancel Editing help (opens in new window)

Templates used on this page: