Comparar revisões

App manifest

Revisão 293175:

Revisão 293175 por lfz em

Revisão 293180:

Revisão 293180 por lfz em

Título:
App manifest
App manifest
Slug:
Apps/Manifest
Apps/Manifest
Conteúdo:

Revisão 293175
Revisão 293180
n17      <h2 id="Example_manifest">n17      <h2 id="Exemplo_de_manifesto">
n56      <h2 id="Fields">n56      <h2 id="Campos">
n197        <a name="path-handling" id="path-handling">All fields than197        <a name="path-handling" id="path-handling">Todos os campo
>t hold paths in the manifest must be absolute paths (for example,>s que se referem álgum caminho no manifesto devem conter caminhos
> '/images/myicon.png'), and are served from the same origin as th> absolutos (por exemplo, '/images/myicon.png'), e serão servidos 
>e app.</a>>a partir da mesma origem que o aplicativo.</a>
n203        <a name="path-handling" id="path-handling">The app manifen203        <a name="path-handling" id="path-handling">O manifesto do
>st must be served from the same origin that the app is served fro> aplicativo deve ser servido da mesma origem a qual o aplicativo 
>m.</a>>está sendo servido.</a>
204      </p>
205      <p>204      </p>
206        <a name="path-handling" id="path-handling">When served fr
>om static files, it is RECOMMENDED that the manifest be stored wi 
>th a file extension of <code>.webapp</code>.&nbsp; App manifests  
>MUST be served with a <code>Content-Type</code> header of <code>a 
>pplication/x-web-app-manifest+json</code> (Note: this is currentl 
>y not enforced by Firefox, but is enforced by Marketplace). Manif 
>ests MAY be served over SSL to mitigate certain classes of attack 
>s.</a> 
207      </p>205      <p>
206        <a name="path-handling" id="path-handling">Quando sendo s
 >ervido a partir de arquivos estáticos, RECOMENDA-SE que o manifes
 >to seja armazenado com uma extensão <code>.webapp</code>.&nbsp; M
 >anifestos de aplicativos DEVEM ser servidos com um header <code>C
 >ontent-Type</code> de <code>application/x-web-app-manifest+json</
 >code> (Nota: isto, no momento, não obrigatório para o Firefox, ma
 >s é obrigatório para o Marketplace). Manifestos PODEM ser servido
 >s usando SSL para mitigar certas classes de ataques.</a>
208      <p>207      </p>
209        <a name="path-handling" id="path-handling">The document i
>s expected to be UTF-8, but another encoding can be specified wit 
>h a <code>charset</code> parameter on the <code>Content-Type</cod 
>e> header (i.e. <code>Content-Type: application/x-web-app-manifes 
>t+json; charset=ISO-8859-4</code>).</a> 
210      </p>208      <p>
209        <a name="path-handling" id="path-handling">Espera-se que 
 >o documento seja UTF-8, mas outra codificação pode ser especifica
 >da com um parâmetro <code>charset</code> no header <code>Content-
 >Type</code>&nbsp; (e.g. <code>Content-Type: application/x-web-app
 >-manifest+json; charset=ISO-8859-4</code>).</a>
211      <p>210      </p>
212        <a name="path-handling" id="path-handling">User Agents wh211      <p>
>en possible SHOULD meaningfully message the site identity and TLS 
> status when prompting a user to install an app.</a> 
212        <a name="path-handling" id="path-handling">User Agents, s
 >empre que possível, DEVERIAM identificar de forma significativa a
 > identidade e status TLS do site ao solicitar que o usuário insta
 >le o aplicativo.</a>
n218        <a name="path-handling" id="path-handling">In your .htaccn218        <a name="path-handling" id="path-handling">Em seu arquivo
>ess file, add thfollowing:</a>> .htaccess, adicione o seguinte:</a>
n225        <a name="path-handling" id="path-handling"><strong>Note:<n225        <a name="path-handling" id="path-handling"><strong>Nota:<
>/strong> This assumes you're using .webapp as an extension. If yo>/strong> Isto assume que você está usando a extensão .webapp. Cas
>u are using .json or another extension, you will have to update t>o você esteja usando .json ou outra extensão, você terá que modif
>he code to reflect that.</a>>icar o código de acordo a refletir isto.</a>
n228        <a name="path-handling" id="path-handling">If you don't hn228        <a name="path-handling" id="path-handling">Caso você não 
>ave a .htaccess file, create it in the root directory of your ser>tenha um arquivo .htaccess, crie um no diretório raiz do seu serv
>ver. If this doesn't work, your host may require you to also add >idor. Se isto não funcionar, o seu host pode exigir que você tamb
><code>AddHandler x-web-app-manifest+json .webapp</code>.</a>>ém inclua <code>AddHandler x-web-app-manifest+json .webapp</code>
 >.</a>
n234        <a name="path-handling" id="path-handling">You need to edn234        <a name="path-handling" id="path-handling">Você precisa e
>it your mime.types file in the conf directory. This will probably>ditar o seu arquivo mime.types no diretório conf. Ele provavelmen
> be located in either /etc/nginx/ or /opt/nginx/.</a>>te se encontra em /etc/nginx/ ou /opt/nginx/.</a>
235      </p>
236      <p>235      </p>
237        <a name="path-handling" id="path-handling">You should hav236      <p>
>e something similar to below. Add in the bolded section.</a> 
237        <a name="path-handling" id="path-handling">Você deve ter 
 >algo similar ao mostrado abaixo. Adicione o texto mostrado em neg
 >rito.</a>
n249        <a name="path-handling" id="path-handling"><strong>Note:<n249        <a name="path-handling" id="path-handling"><strong>Nota:<
>/strong> This assumes you're using .webapp as an extension. If yo>/strong> Isto assume que você está usando a extensão .webapp. Cas
>u are using .json or another extension, you will have to update t>o você esteja usando .json ou outra extensão, você terá que modif
>he code to reflect that.</a>>icar o código de acordo a refletir isto.</a>
n255        <a name="path-handling" id="path-handling">If you serve yn255        <a name="path-handling" id="path-handling">Caso você sirv
>our manifest file from GitHub Pages (</a><a class="external" href>a seu arquivo de manifesto a partir das páginas hospedadas no Git
>="http://pages.github.com/" title="http://pages.github.com/">http>Hub (</a><a class="external" href="http://pages.github.com/" titl
>://pages.github.com/</a>), GitHub will serve it with the correct >e="http://pages.github.com/">http://pages.github.com/</a>), o Git
>header. You must use the <code>.webapp</code> file extension on y>Hub irá serví-la com o header correto. Você deve usar a extensão 
>our manifest file. Example: <code>manifest.webapp</code>.><code>.webapp</code> para seu arquivo manifesto. Examplo: <code>m
 >anifest.webapp</code>.
t258        Updating manifestst258        Atualizando manifestos
259      </h2>
260      <p>259      </h2>
261        An app respects the normal rules for Web caching, and may
> optionally use advanced mechanisms for improved start-up, like t 
>he <a class="external" href="http://www.whatwg.org/specs/web-apps 
>/current-work/multipage/offline.html#offline">HTML5 AppCache</a>. 
> Given this, there are no special considerations for updating the 
> normal resources that an app uses. 
262      </p>260      <p>
261        Um aplicativo respeita as regras normais de Web caching e
 > pode, opcionalmente, utilizar mecanismos avançados para acelerar
 > sua inicialização, como o <a class="external" href="http://www.w
 >hatwg.org/specs/web-apps/current-work/multipage/offline.html#offl
 >ine">HTML5 AppCache</a>. Dito isto, não existem considerações esp
 >eciais para atualizar os recursos normais que um aplicativo usa.
263      <p>262      </p>
264        Web apps are different, however, in the handling of the m
>anifest. Some changes to a manifest may require user approval. De 
>pending on the implementation of the app repository, it may be un 
>clear whether an update has occurred. 
265      </p>263      <p>
264        Aplicativos Web são differentes, entretanto, na gerencia 
 >do manifesto. Algumas mudanças feitas ao manifesto podem requerir
 > aprovação do usuário. Dependendo da implementação do repositório
 > de aplicativos, pode não ficar claro se uma atualização acontece
 >u.
266      <p>265      </p>
267        As a clean way to deal with this issue, you can provide a
> <code>version</code> property in the app manifest. You can later 
> check the version by inspecting the return value of the <a href= 
>"/en/DOM/Apps.getInstalled" title="en/Apps/Apps_JavaScript_API/na 
>vigator.mozApps.getInstalled"><code>navigator.mozApps.getInstalle 
>d()</code></a> function. If the user's installed version is not u 
>p-to-date, you can trigger an update using <code><a href="/en/DOM 
>/Apps.install" title="https://developer.mozilla.org/en/Apps/Apps_ 
>JavaScript_API/navigator.mozApps.install">navigator.mozApps.insta 
>ll()</a>.</code> 
268      </p>266      <p>
267        Para lidar de uma maneira limpa com esta situação, você p
 >ode prover um campo <code>version</code> no manifesto do aplicati
 >vo. Depois disto você pode checar a versão utilizando o retorno d
 >a função <a href="/en/DOM/Apps.getInstalled" title="en/Apps/Apps_
 >JavaScript_API/navigator.mozApps.getInstalled"><code>navigator.mo
 >zApps.getInstalled()</code></a>. Caso a versão instalada pelo usu
 >ário não seja a mais atual, você pode iniciar uma atualização usa
 >ndo a função <code><a href="/en/DOM/Apps.install" title="https://
 >developer.mozilla.org/en/Apps/Apps_JavaScript_API/navigator.mozAp
 >ps.install">navigator.mozApps.install()</a>.</code>
269      <p>268      </p>
270        The value of <code>version</code> is an opaque string to 269      <p>
>the repository, so you can use whatever versioning scheme you wan 
>t. 
270        O valor de <code>version</code> é uma string opaca ao rep
 >ositório, então você pode usar qualquer esquema de versionamento 
 >que você quiser.

Voltar ao histórico