preview/features/runtime-permissions.jd

page.title=Permisos
page.tags=previewresources, androidm
page.keywords=permissions, runtime, preview
page.image={@docRoot}preview/features/images/permissions_check.png
@jd:body


<div id="qv-wrapper">
  <div id="qv">
    <h2>Quickview</h2>
    <ul>
      <li>Si su aplicacin tiene como destino el SDK de la versin preliminar de Android M, se solicitar a los usuarios que concedan permisos durante el tiempo de ejecucin, en lugar de durante la instalacin.
</li>
      <li>Los usuarios pueden cancelar los permisos en cualquier momento desde la pantalla Settings de la aplicacin.
</li>
      <li>La aplicacin necesita controlar los permisos cada vez que se ejecuta.
</li>
    </ul>

    <h2>Contenido del documento</h2>
    <ol>
      <li><a href="#overview">Informacin general</a></li>
      <li><a href="#coding">Codificacin para permisos de tiempo de ejecucin</a></li>
      <li><a href="#testing">Prueba de permisos de tiempo de ejecucin</a></li>
      <li><a href="#best-practices">Mejores prcticas</a></li>
    </ol>

<!--
  <h2>Related Samples</h2>
  <ol>
    <li></li>
  </ol>
-->

<!--
  <h2>See also</h2>
  <ol>
    <li></li>
  </ol>
-->
  </div> <!-- qv -->
</div> <!-- qv-wrapper -->


<p>
  M Developer Preview introduce un nuevo modelo de permisos de la aplicacin que facilita a los usuarios el proceso de instalacin y actualizacin de aplicaciones.
 Si una aplicacin que se ejecuta en la versin preliminar de Android M es compatible con el nuevo modelo de permisos, el usuario no tiene que conceder ningn permiso al instalar o actualizar la aplicacin. En su lugar, la aplicacin solicitar los permisos a medida que los vaya necesitado y el sistema mostrar al usuario un dilogo en el que le solicitar los permisos necesarios.


</p>

<p>
  Si la aplicacin es compatible con el nuevo modelo de permisos, podr instalarse y ejecutarse en los dispositivos con versiones anteriores de Android, utilizando el modelo de permisos anterior en esos dispositivos.


</p>

<h2 id="overview">
  Informacin general
</h2>

<p>
  En M Developer Preview, la plataforma introduce un nuevo modelo
de permisos de la aplicacin. A continuacin, se presenta un resumen de los componentes principales de este nuevo modelo:
</p>

<ul>
  <li>
    <strong>Declaracin de los permisos:</strong> Al igual que en las plataformas anteriores de Android, la aplicacin declara todos los permisos que necesita en el manifiesto.

  </li>

  <li>
    <strong>Grupos de permisos:</strong> Segn su funcin, los permisos se dividen en
<em>grupos de permisos</em>. Por ejemplo, el grupo de permisos
<code>CONTACTS</code> contiene permisos para leer y escribir los contactos y la informacin de perfil del usuario.

  </li>

  <li>
    <p><strong>Permisos limitados concedidos durante la instalacin:</strong> Cuando el usuario instala o actualiza la aplicacin, el sistema le concede a la aplicacin todos los permisos que la aplicacin solicita que corresponden a {@link
    android.content.pm.PermissionInfo#PROTECTION_NORMAL PROTECTION_NORMAL}.


    Por ejemplo, los permisos para la alarma y los permisos de intento corresponden a {@link
    android.content.pm.PermissionInfo#PROTECTION_NORMAL PROTECTION_NORMAL}, por lo que se conceden automticamente durante la instalacin.

    </p>

    <p>El sistema puede concederle a la aplicacin permisos de firma y de sistema, como se especifica en la seccin <a href="#system-apps">Permisos de firma y de sistema de la aplicacin</a>.

 Al usuario <em>no</em> se le solicitar conceder ningn permiso durante la instalacin.
</p>
  </li>

  <li>
    <strong>Solicitud de permisos al usuario durante el tiempo de ejecucin:</strong> Cuando la aplicacin solicita un permiso, el sistema le muestra al usuario un dilogo y luego llama a la funcin de devolucin de llamada de la aplicacin para notificarle si el permiso se otorg.

 Si el usuario concede un permiso, la aplicacin recibe todos los permisos del rea funcional de dicho permiso, los cuales fueron declarados en el manifiesto de la aplicacin.


  </li>

</ul>

<p>
  Este modelo de permisos cambia la forma en la que la aplicacin se comporta para caractersticas que requieren permisos.
 A continuacin, se presenta un resumen de las prcticas de desarrollo que debe seguir para ajustarse a este modelo:

</p>

<ul>

  <li>
    <strong>Siempre compruebe los permisos:</strong> Siempre que una aplicacin necesite realizar una accin que requiere algn permiso, primero debe comprobar si ya tiene otorgado ese permiso.

 En caso de no tenerlo, solicitar que se le otorgue ese permiso.

  </li>

  <li>
    <strong>Administre la falta de permisos correctamente:</strong> Si la aplicacin no recibe un permiso adecuado, deber administrar la falla sin errores.

    Por ejemplo, si se necesita el permiso solo para una caracterstica aadida, la aplicacin puede desactivar esa caracterstica.
 Si el permiso es fundamental para que la aplicacin funcione, la aplicacin podr desactivar toda su funcionalidad e informar al usuario que se deben conceder dichos permisos.


  </li>

  <div class="figure" style="width:220px" id="fig-perms-screen">
    <img src="{@docRoot}preview/features/images/app-permissions-screen_2x.png" srcset="{@docRoot}preview/features/images/app-permissions-screen.png 1x, {@docRoot}preview/features/images/app-permissions-screen_2x.png 2x" alt="" width="220">
    <p class="img-caption">
      <strong>Figura 1</strong> Pantalla de permisos en Settings de la aplicacin.
    </p>
  </div>

  <li>
    <strong>Los permisos son revocables:</strong> Los usuarios pueden revocar los permisos en cualquier momento.
 Si un usuario desactiva los permisos de una aplicacin, la aplicacin <em>no</em> recibe ningn aviso.
 Nuevamente, la aplicacin deber verificar que cuenta con los permisos necesarios antes de realizar cualquier accin restringida.

  </li>
</ul>

<p class="note">
  <strong>Nota:</strong> Si una aplicacin tiene como destino M Developer Preview, <em>debe</em> utilizar el nuevo modelo de permisos.

</p>

<p>
  A partir del lanzamiento de M Developer Preview, no todas las aplicaciones de Google implementarn por completo el nuevo modelo de permisos.
 Google actualiza estas aplicaciones durante el transcurso de M Developer Preview para respetar adecuadamente las configuraciones de alternancia de los permisos.


</p>

<p class="note">
  <strong>Nota:</strong> Si la aplicacin cuenta con su propia superficie de API, no transmita permisos sin antes asegurarse de que el iniciador de la llamada cuente con los permisos requeridos para acceder a esa informacin.


</p>

<h3 id="system-apps">
  Permisos de las aplicaciones de firma y de sistema
</h3>

<p>
  Generalmente, cuando el usuario instala una aplicacin, el sistema solo otorga a la aplicacin
{@link android.content.pm.PermissionInfo#PROTECTION_NORMAL
  PROTECTION_NORMAL}. Sin embargo, en ciertas circunstancias, el sistema le concede a la aplicacin ms permisos:

</p>

<ul>
  <li>Si una aplicacin es parte de la imagen del sistema, la aplicacin recibe automticamente todos los permisos enumerados en el manifiesto.

  </li>

  <li>Si la aplicacin solicita permisos en el manifiesto que corresponden a {@link
  android.content.pm.PermissionInfo#PROTECTION_SIGNATURE PROTECTION_SIGNATURE} y la aplicacin est firmada con el mismo certificado que el de la aplicacin que declar dichos permisos, el sistema le concede a la aplicacin que los solicita esos permisos durante la instalacin.


  </li>
</ul>

<p>
  En ambos casos, el usuario an puede revocar los permisos en cualquier momento si accede a la pantalla <strong>Settings</strong> del sistema y selecciona <strong>Apps &gt;</strong>

 <i>app_name</i> <strong>&gt; Permissions</strong>. La aplicacin debe seguir controlando los permisos al momento de la ejecucin y solicitarlos si fuese necesario.


</p>

<h3 id="compatibility">
  Compatibilidad con modelos anteriores y posteriores
</h3>

<p>
  Si una aplicacin no tiene como destino M Developer Preview, la aplicacin contina utilizando el modelo de permisos anterior, incluso en dispositivos con la versin preliminar de Android M.
 Cuando el usuario instala la aplicacin, el sistema le solicita al usuario que otorgue todos los permisos enumerados en el manifiesto de la aplicacin.


</p>

<p class="note">
  <strong>Nota:</strong> En dispositivos que ejecutan M Developer Preview, el usuario puede desactivar los permisos para cualquier aplicacin (incluso para aplicaciones heredadas) desde la pantalla Settings de la aplicacin.

 Si un usuario desactiva permisos para una aplicacin heredada, el sistema desactiva las funciones correspondientes de forma automtica.
 Cuando la aplicacin intenta realizar una operacin que requiere ese permiso, la operacin no generar necesariamente una excepcin.

 En su lugar, devolver un conjunto de datos vacos, indicar un error o, de lo contrario, mostrar un comportamiento inesperado.
 Por ejemplo, si realiza una consulta sobre el calendario sin permisos, el mtodo devuelve un conjunto de datos vacos.

</p>

<p>
  Si instala una aplicacin que utiliza el nuevo modelo de permisos en un dispositivo que no ejecuta la versin preliminar de Android M, el sistema la trata como cualquier otra aplicacin: el sistema le pide al usuario, durante la instalacin, que conceda los permisos declarados.


</p>

<p class="note">
  <strong>Nota:</strong> Para el lanzamiento de la versin preliminar, debe configurar la versin mnima del SDK en M Preview SDK para compilar con la versin del SDK preliminar.
 Esto significa que no podr probar dichas aplicaciones en plataformas anteriores durante la versin preliminar para desarrolladores.


</p>

<h3 id="perms-vs-intents">Permisos frente a intentos</h3>

<p>
  En muchas situaciones, puede elegir entre dos formas para que sus aplicaciones realicen una tarea.
 Puede hacer que su aplicacin solicite permiso para realizar la operacin por s misma.
 De lo contrario, puede hacer que la aplicacin utilice un intento para que otra aplicacin realice la tarea.

</p>

<p>
  Por ejemplo, supongamos que su aplicacin necesita poder tomar fotografas con la cmara del dispositivo.
 Su aplicacin puede solicitar el permiso
<code>android.permission.CAMERA</code>, lo que le permite a su aplicacin acceder a la cmara directamente.
 Entonces, su aplicacin utilizar las API de la cmara para controlar la cmara y tomar una fotografa.
 Este enfoque le otorga a su aplicacin total control del proceso de fotografa y le permite incorporar la UI de la cmara en su aplicacin.


</p>

<p>
  Sin embargo, si no necesita dicho control, puede utilizar {@link
  android.provider.MediaStore#ACTION_IMAGE_CAPTURE ACTION_IMAGE_CAPTURE} para solicitar una imagen.
 Cuando ejecute el intento, se le solicita al usuario que elija una aplicacin de cmara (en caso de que no haya una aplicacin de cmara predeterminada) y esa aplicacin tomar la fotografa.

 La aplicacin de cmara devuelve la fotografa al mtodo {@link
  android.app.Activity#onActivityResult onActivityResult()} de su aplicacin.
</p>

<p>
  De manera similar, si necesita realizar una llamada telefnica, acceder a los contactos del usuario, etc., lo puede hacer creando intentos apropiados o puede solicitar los permisos e ingresar directamente a los objetos apropiados.

 Cada enfoque tiene ventajas y desventajas.

</p>

<p>
  Si utiliza los permisos:
</p>

<ul>
  <li>La aplicacin posee total control sobre la experiencia del usuario cuando usted realiza la operacin.
 Sin embargo, un control tan amplio complica su tarea, ya que usted deber disear una UI apropiada.

  </li>

  <li>Se le solicita al usuario otorgar el permiso una vez, la primera vez que usted realiza la operacin.
 Luego, su aplicacin puede realizar la operacin sin requerir interaccin adicional por parte del usuario.
 Sin embargo, si el usuario no concede el permiso (o lo revoca luego), su aplicacin queda inhabilitada para realizar la operacin.


  </li>
</ul>

<p>
  Si utiliza un intento:
</p>

<ul>
  <li>No debe disear la UI para la operacin. La aplicacin que controla el intento provee la UI. Sin embargo, esto significa que usted no tiene control sobre la experiencia del usuario.

 El usuario podr interactuar con una aplicacin que usted no conoce.

  </li>

  <li>Si el usuario no tiene una aplicacin predeterminada para la operacin, el sistema le solicita al usuario que elija una aplicacin. Si el usuario no designa un controlador predeterminado, es probable que surja un dilogo adicional cada vez que realice la operacin.


  </li>
</ul>

<h2 id="coding">Codificacin para permisos de tiempo de ejecucin</h2>

<p>
  Si su aplicacin tiene como destino el nuevo M Developer Preview, deber usar el nuevo modelo de permisos.
  Esto significa que, adems de declarar los permisos necesarios en el manifiesto, tambin debe comprobar si tiene los permisos de tiempo de ejecucin y solicitarlos en caso de no tenerlos.


</p>

<h3 id="enabling">
  Habilitar el nuevo modelo de permisos
</h3>

<p>
  Para habilitar el nuevo modelo de permisos de M Developer Preview, configure el atributo
<code>targetSdkVersion</code> de la aplicacin en <code>"MNC"</code> y
<code>compileSdkVersion</code> en <code>"android-MNC"</code>. Al hacerlo, se habilitan todas las caractersticas de los nuevos permisos.

</p>

<p>
  Para el lanzamiento de la versin preliminar, debe establecer <code>minSdkVersion</code> en
<code>"MNC"</code> para compilar con el SDK preliminar.
</p>

<h3 id="m-only-perm">
  Establecer un permiso solo para la versin preliminar de Android M
</h3>

<p>
  Puede utilizar el nuevo elemento <code>&lt;uses-permission-sdk-m&gt;</code> en el manifiesto de la aplicacin para indicar que se necesita un permiso solo para M Developer Preview.
 Si declara un permiso de esta manera, cuando la aplicacin se instale en un dispositivo anterior, el sistema no le solicitar al usuario el permiso ni se lo otorgar a la aplicacin. Al usar el elemento <code>&lt;uses-permission-sdk-m&gt;</code>, puede aadir nuevos permisos a las versiones actualizadas de su aplicacin sin forzar a los usuarios a otorgar permisos cuando instalen la actualizacin.


</p>

<p>
  Si la aplicacin se ejecuta en un dispositivo con M Developer Preview,
<code>&lt;uses-permission-sdk-m&gt;</code> se comporta al igual que
<code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html">&lt;uses-permission&gt;</a></code>.
  El sistema no le solicita al usuario que otorgue ningn permiso al instalar la aplicacin y la aplicacin solicita los permisos a medida que se necesiten.

</p>

<h3 id="prompting">
  Solicitar permisos
</h3>

<p>
  Si su aplicacin utiliza el nuevo modelo de permisos de M Developer Preview, no se le pedir al usuario que otorgue todos los permisos cuando la aplicacin se ejecute por primera vez en un dispositivo con la versin preliminar de Android M.

 En su lugar, su aplicacin solicita los permisos a medida que los necesita.
 Cuando su aplicacin solicita un permiso, el sistema le muestra un dilogo al usuario.

</p>

<p>
  Si su aplicacin se ejecuta en un dispositivo con SDK 22 o anterior, la aplicacin utiliza el modelo de permisos anterior.
 Cuando el usuario instala la aplicacin, se le solicita que otorgue todos los permisos que la aplicacin requiere en su manifiesto, excepto aquellos permisos marcados con <code>&lt;uses-permission-sdk-m&gt;</code>.


</p>

<h4 id="check-platform">Controlar en qu plataforma se ejecuta la aplicacin</h4>

<p>
  Este modelo de permisos es compatible solamente con dispositivos que ejecutan M Developer Preview.
 Antes de llamar a cualquiera de estos mtodos, la aplicacin debe verificar en qu plataforma se est ejecutando y, para hacerlo, se controla el valor de {@link android.os.Build.VERSION#CODENAME
  Build.VERSION.CODENAME}.

 Si el dispositivo ejecuta M Developer Preview,
{@link android.os.Build.VERSION#CODENAME CODENAME} es <code>"MNC"</code>.
</p>

<h4 id="check-for-permission">Controlar si la aplicacin cuenta con los permisos necesarios</h4>

<p>Cuando el usuario intenta realizar algo que requiere un permiso, la aplicacin controla si ya tiene el permiso para realizar esa operacin.
 Para hacerlo, la aplicacin llama a <code>Context.checkSelfPermission(

<i>permission_name</i>)</code>. La aplicacin debe realizar este control incluso si sabe que el usuario ya ha concedido ese permiso, ya que el usuario puede revocar los permisos de una aplicacin en cualquier momento.


 Por ejemplo, si un usuario quiere usar una aplicacin para tomar una fotografa, la aplicacin llama a <code>Context.checkSelfPermission(Manifest.permission.CAMERA)</code>.

</p>

<p class="table-caption" id="permission-groups">
  <strong>Tabla 1.</strong> Permisos y grupo de permisos.</p>
<table>
  <tr>
    <th scope="col">Grupo de permisos</th>
    <th scope="col">Permisos</th>
  </tr>

  <tr>
    <td><code>android.permission-group.CALENDAR</code></td>
    <td>
      <ul>
        <li>
          <code>android.permission.READ_CALENDAR</code>
        </li>
      </ul>
      <ul>
        <li>
          <code>android.permission.WRITE_CALENDAR</code>
        </li>
      </ul>
    </td>
  </tr>

  <tr>
    <td><code>android.permission-group.CAMERA</code></td>
    <td>
      <ul>
        <li>
          <code>android.permission.CAMERA</code>
        </li>
      </ul>
    </td>
  </tr>

  <tr>
    <td><code>android.permission-group.CONTACTS</code></td>
    <td>
      <ul>
        <li>
          <code>android.permission.READ_CONTACTS</code>
        </li>
        <li>
          <code>android.permission.WRITE_CONTACTS</code>
        </li>
        <li>
          <code>android.permission.READ_PROFILE</code>
        </li>
        <li>
          <code>android.permission.WRITE_PROFILE</code>
        </li>
      </ul>
    </td>
  </tr>

  <tr>
    <td><code>android.permission-group.LOCATION</code></td>
    <td>
      <ul>
        <li>
          <code>android.permission.ACCESS_FINE_LOCATION</code>
        </li>
        <li>
          <code>android.permission.ACCESS_COARSE_LOCATION</code>
        </li>
      </ul>
    </td>
  </tr>

  <tr>
    <td><code>android.permission-group.MICROPHONE</code></td>
    <td>
      <ul>
        <li>
          <code>android.permission.RECORD_AUDIO</code>
        </li>
      </ul>
    </td>
  </tr>

  <tr>
    <td><code>android.permission-group.PHONE</code></td>
    <td>
      <ul>
        <li>
          <code>android.permission.READ_PHONE_STATE</code>
        </li>
        <li>
          <code>android.permission.CALL_PHONE</code>
        </li>
        <li>
          <code>android.permission.READ_CALL_LOG</code>
        </li>
        <li>
          <code>android.permission.WRITE_CALL_LOG</code>
        </li>
        <li>
          <code>com.android.voicemail.permission.ADD_VOICEMAIL</code>
        </li>
        <li>
          <code>android.permission.USE_SIP</code>
        </li>
        <li>
          <code>android.permission.PROCESS_OUTGOING_CALLS</code>
        </li>
      </ul>
    </td>
  </tr>

  <tr>
    <td><code>android.permission-group.SENSORS</code></td>
    <td>
      <ul>
        <li>
          <code>android.permission.BODY_SENSORS</code>
        </li>
      </ul>
      <ul>
        <li>
          <code>android.permission.USE_FINGERPRINT</code>
        </li>
      </ul>
    </td>
  </tr>

  <tr>
    <td><code>android.permission-group.SMS</code></td>
    <td>
      <ul>
        <li>
          <code>android.permission.SEND_SMS</code>
        </li>
        <li>
          <code>android.permission.RECEIVE_SMS</code>
        </li>
        <li>
          <code>android.permission.READ_SMS</code>
        </li>
        <li>
          <code>android.permission.RECEIVE_WAP_PUSH</code>
        </li>
        <li>
          <code>android.permission.RECEIVE_MMS</code>
        </li>
        <li>
          <code>android.permission.READ_CELL_BROADCASTS</code>
        </li>
      </ul>
    </td>
  </tr>

</table>

<h4 id="request-permissions">Solicitar permisos si se necesitan</h4>

<p>Si la aplicacin no posee los permisos que necesita, llama al mtodo
<code>Activity.requestPermissions(String[], int)</code> para solicitar el permiso o los permisos apropiados.
 La aplicacin pasa el permiso o los permisos que necesita y un cdigo de solicitud entero.

  Este mtodo funciona de manera asincrnica: realiza la devolucin inmediatamente y cuando el usuario responde a la ventana de dilogo, el sistema llama al mtodo de devolucin de llamada de la aplicacin con los resultados, y pasa el mismo cdigo de solicitud que pas la aplicacin a
<code>requestPermissions()</code>.

</p>

  <p>El siguiente cdigo verifica si la aplicacin tiene permisos para leer los contactos del usuario y solicita los permisos de ser necesario:
</p>

<pre>
if (checkSelfPermission(Manifest.permission.READ_CONTACTS)
        != PackageManager.PERMISSION_GRANTED) {
    requestPermissions(new String[]{Manifest.permission.READ_CONTACTS},
            MY_PERMISSIONS_REQUEST_READ_CONTACTS);

    // MY_PERMISSIONS_REQUEST_READ_CONTACTS is an
    // app-defined int constant

    return;
}
</pre>

<h4 id="handle-response">Administrar la respuesta a la solicitud de permisos</h4>

<p>
  Cuando una aplicacin solicita permisos, el sistema le muestra al usuario una ventana de dilogo.
 Cuando el usuario responde, el sistema invoca
<code>Activity.onRequestPermissionsResult(int, String[], int[])</code>
 de su aplicacin y le transfiere la respuesta del usuario. Su aplicacin necesita invalidar ese mtodo. La devolucin de llamada pasa el mismo cdigo de solicitud que usted pas a <code>requestPermissions()</code>.

 Por ejemplo, si una aplicacin solicita acceso <code>READ_CONTACTS</code>, es posible que tenga el siguiente mtodo de devolucin de llamada:


</p>

<pre>
&#64;Override
public void onRequestPermissionsResult(int requestCode,
        String permissions[], int[] grantResults) {
    switch (requestCode) {
        case MY_PERMISSIONS_REQUEST_READ_CONTACTS: {
            if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {

                // permission was granted, yay! do the
                // calendar task you need to do.

            } else {

                // permission denied, boo! Disable the
                // functionality that depends on this permission.
            }
            return;
        }

        // other 'switch' lines to check for other
        // permissions this app might request
    }
}
</pre>

  <p>Si el usuario concede un permiso, el sistema le otorga a la aplicacin todos los permisos enumerados en el manifiesto para esa rea funcional.
 Se deben tomar acciones apropiadas si el usuario rechaza la solicitud.
 Por ejemplo, usted podra desactivar cualquier accin del men que dependa de este permiso.

  </li>
</p>

<p>
  Cuando el sistema le solicita al usuario que otorgue un permiso, el usuario tiene la opcin de indicarle al sistema que no solicite ese permiso de nuevo.
 En ese caso, cuando la aplicacin utiliza <code>requestPermissions()</code> para solicitar ese permiso, el sistema rechaza la solicitud inmediatamente.

 En este caso, el sistema llama a su <code>onRequestPermissionsResult()</code> de la misma manera en que lo hara si el usuario hubiese rechazado explcitamente su solicitud nuevamente.

 Por esta razn, su aplicacin no puede asumir que se ha llevado a cabo algn tipo de interaccin con el usuario.

</p>

<h2 id="testing">Prueba de permisos de tiempo de ejecucin</h2>


<p>
  Si su aplicacin tiene como destino M Developer Preview, debe probar que administre los permisos correctamente.
 No debe asumir que su aplicacin tiene algn permiso en particular cuando se ejecuta.
 Cuando la aplicacin se ejecuta por primera vez, es muy probable que no tenga permisos y el usuario puede revocar o reestablecer los permisos en cualquier momento.


</p>

<p>
  Debe probar su aplicacin para asegurarse de que funciona correctamente en todas las situaciones de permisos.
 Con el SDK de la versin preliminar de Android M, hemos brindado nuevos comandos <a href="{@docRoot}tools/help/adb.html">Android Debug Bridge (adb)</a> que le permitirn probar su aplicacin con cualquier configuracin de permisos que necesite probar.


</p>

<h3>
  Nuevas opciones y comandos adb
</h3>

<p>
  Las herramientas de plataforma del SDK de la versin preliminar de Android M contienen varios comandos nuevos que le permiten probar la manera en que su aplicacin administra los permisos.

</p>

<h4>
  Instalar con permisos
</h4>

<p>
  Puede utilizar la nueva opcin <code>-g</code> del comando <a href="{@docRoot}tools/help/adb.html#move"><code>adb
  install</code></a>, que instala la aplicacin y concede todos los permisos enumerados en el manifiesto de la aplicacin:

</p>

<pre class="no-pretty-print">
$ adb install -g &lt;path_to_apk&gt;
</pre>

<h4>
  Conceder y revocar permisos
</h4>

<p>
  Puede utilizar los comandos ADB nuevos <a href="{@docRoot}tools/help/adb.html#pm">package manager (pm)</a> para conceder y revocar permisos a una aplicacin instalada. Esta funcionalidad puede resultar til para pruebas automticas.


</p>

<p>
  Para conceder un permiso, utilice el comando <code>grant</code> de package manager:
</p>

<pre class="no-pretty-print">
$ adb pm grant &lt;package_name&gt; &lt;permission_name&gt;
</pre>

<p>
  Por ejemplo, para conceder el paquete de permisos com.example.myapp para grabar audio utilice este comando:

</p>

<pre class="no-pretty-print">
$ adb pm grant com.example.myapp android.permission.RECORD_AUDIO
</pre>

<p>
  Para revocar un permiso, utilice el comando <code>revoke</code> de package manager:
</p>

<pre class="no-pretty-print">
$ adb pm revoke &lt;package_name&gt; &lt;permission_name&gt;
</pre>

<h2 id="best-practices">Mejores prcticas</h2>

<p>
  El nuevo modelo de permisos brinda a los usuarios una experiencia ms fluida y les facilita la instalacin de aplicaciones, adems de hacerlos sentir cmodos con las actividades de sus aplicaciones.

 Sugerimos las siguientes mejores prcticas para obtener el mayor beneficio del nuevo modelo.

</p>


<h3 id="bp-what-you-need">Solicite solo los permisos que necesite</h3>

<p>
  Cada vez que solicite un permiso, usted obliga al usuario a tomar una decisin.
  La funcionalidad de su aplicacin se ver reducida si el usuario rechaza la solicitud.
  Debe minimizar la cantidad de veces que realiza estas solicitudes.
</p>

<p>
  Por ejemplo, a menudo, su aplicacin puede obtener la funcionalidad necesaria a travs de un <a href="{@docRoot}guide/components/intents-filters.html">intento</a> en lugar de una solicitud de permiso.

 Si su aplicacin necesita tomar fotografas con la cmara del telfono, la aplicacin puede utilizar un intento {@link
  android.provider.MediaStore#ACTION_IMAGE_CAPTURE
  MediaStore.ACTION_IMAGE_CAPTURE}.
  Cuando su aplicacin ejecuta el intento, el sistema le solicita al usuario que elija una aplicacin para la cmara que ya est instalada a fin de tomar la fotografa.


</p>

<h3 id="bp-dont-overwhelm">
  No abrume al usuario
</h3>

<p>
  Si expone al usuario a muchas solicitudes de permisos al mismo tiempo, lo abrumar y har que deje de usar su aplicacin. Por el contrario, debe pedir permisos en la medida que los necesite.


</p>

<p>
  A veces, uno o ms permisos pueden ser absolutamente necesarios para la aplicacin. En ese caso, es recomendable pedir todos los permisos no bien se inicie la aplicacin.

 Por ejemplo, si crea una aplicacin de fotografa, la aplicacin necesitar acceso a la cmara del dispositivo.
 Cuando el usuario inicie la aplicacin por primera vez, no se sorprender si la aplicacin le solicita permiso para usar la cmara.

 Sin embargo, si la misma aplicacin adems tuviese una caracterstica para compartir fotografas con los contactos del usuario, <em>no</em> solicite ese permiso la primera vez que se ejecute.

 En su lugar, espere hasta que el usuario utilice la caracterstica compartir para solicitar el permiso en ese momento.

</p>

<p>
  Si su aplicacin proporciona un tutorial, se recomienda que se pidan los permisos esenciales de la aplicacin al final del tutorial.

</p>

<h3 id="bp-explain">
  Explique por qu se necesitan los permisos
</h3>

<p>
  El dilogo de permisos que muestra el sistema cuando llama a
 <code>requestPermissions()</code> informa qu permisos necesita su aplicacin pero no establece el motivo.
 A veces, el usuario puede confundirse.
  Es una buena idea explicarle al usuario los motivos por los que la aplicacin necesita esos permisos antes de llamar a <code>requestPermissions()</code>.

</p>

<p>
  Por ejemplo, una aplicacin de fotografa puede solicitar servicios de ubicacin para aadir una etiqueta geogrfica a las fotografas.
 Es posible que un usuario tpico no sepa que una fotografa puede contener informacin sobre la ubicacin y se confundira si una aplicacin de fotografa solicita la ubicacin.

 En este caso, es recomendable que la aplicacin le informe al usuario acerca de esta caracterstica <em>antes</em> de llamar a
<code>requestPermissions()</code>.

</p>

<p>
  Una forma de hacerlo es incorporar estas solicitudes en el tutorial de la aplicacin. El tutorial puede mostrar todas las caractersticas de la aplicacin, una por vez, y mientras lo hace explicar los permisos que son necesarios.

 Por ejemplo, el tutorial de la aplicacin de fotografa puede mostrar la caracterstica compartir fotografas con contactos y luego explicarle al usuario que debe otorgar permisos para que la aplicacin vea los contactos del usuario.


 La aplicacin puede entonces llamar a <code>requestPermissions()</code> para solicitarle al usuario ese acceso.
 Por supuesto, no todos los usuarios siguen el tutorial, por lo que aun as debe controlar y solicitar los permisos durante el funcionamiento normal de la aplicacin.


</p>