SQLite Android Bindings

Hex Artifact Content
Login

Artifact 90fd4b760405f79550818402e5389821dba22f1f:


0000: 0a 3c 68 31 3e 49 6e 73 74 61 6c 6c 61 74 69 6f  .<h1>Installatio
0010: 6e 3c 2f 68 31 3e 0a 0a 0a 3c 70 3e 20 54 68 65  n</h1>...<p> The
0020: 72 65 20 61 72 65 20 74 68 72 65 65 20 77 61 79  re are three way
0030: 73 20 74 6f 20 61 64 64 20 74 68 65 20 53 51 4c  s to add the SQL
0040: 69 74 65 20 41 6e 64 72 6f 69 64 20 62 69 6e 64  ite Android bind
0050: 69 6e 67 73 20 74 6f 20 61 6e 20 61 70 70 6c 69  ings to an appli
0060: 63 61 74 69 6f 6e 3a 0a 0a 3c 6f 6c 3e 0a 20 20  cation:..<ol>.  
0070: 3c 6c 69 3e 20 42 79 20 61 64 64 69 6e 67 20 61  <li> By adding a
0080: 20 70 72 65 2d 62 75 69 6c 74 20 61 61 72 20 66   pre-built aar f
0090: 69 6c 65 20 74 6f 20 74 68 65 20 61 70 70 6c 69  ile to the appli
00a0: 63 61 74 69 6f 6e 73 20 0a 20 20 3c 61 20 68 72  cations .  <a hr
00b0: 65 66 3d 68 74 74 70 73 3a 2f 2f 64 65 76 65 6c  ef=https://devel
00c0: 6f 70 65 72 2e 61 6e 64 72 6f 69 64 2e 63 6f 6d  oper.android.com
00d0: 2f 73 74 75 64 69 6f 2f 69 6e 64 65 78 2e 68 74  /studio/index.ht
00e0: 6d 6c 3e 41 6e 64 72 6f 69 64 20 53 74 75 64 69  ml>Android Studi
00f0: 6f 3c 2f 61 3e 0a 20 20 20 20 20 20 20 70 72 6f  o</a>.       pro
0100: 6a 65 63 74 2e 0a 0a 20 20 3c 6c 69 3e 20 42 79  ject...  <li> By
0110: 20 62 75 69 6c 64 69 6e 67 20 61 6e 20 61 61 72   building an aar
0120: 20 66 69 6c 65 2c 20 74 68 65 6e 20 61 64 64 69   file, then addi
0130: 6e 67 20 69 74 20 74 6f 20 74 68 65 20 61 70 70  ng it to the app
0140: 6c 69 63 61 74 69 6f 6e 73 20 41 6e 64 72 6f 69  lications Androi
0150: 64 0a 20 20 20 20 20 20 20 53 74 75 64 69 6f 20  d.       Studio 
0160: 70 72 6f 6a 65 63 74 20 61 73 20 69 6e 20 28 31  project as in (1
0170: 29 2e 0a 0a 20 20 3c 6c 69 3e 20 42 79 20 61 64  )...  <li> By ad
0180: 64 69 6e 67 20 74 68 65 20 53 51 4c 69 74 65 20  ding the SQLite 
0190: 41 6e 64 72 6f 69 64 20 62 69 6e 64 69 6e 67 73  Android bindings
01a0: 20 73 6f 75 72 63 65 20 63 6f 64 65 20 74 6f 20   source code to 
01b0: 61 6e 64 20 62 75 69 6c 64 69 6e 67 20 69 74 20  and building it 
01c0: 0a 20 20 20 20 20 20 20 61 6c 6f 6e 67 20 77 69  .       along wi
01d0: 74 68 20 74 68 65 20 6f 74 68 65 72 20 61 70 70  th the other app
01e0: 6c 69 63 61 74 69 6f 6e 20 63 6f 64 65 2e 0a 3c  lication code..<
01f0: 2f 6f 6c 3e 0a 0a 3c 70 3e 20 42 79 20 64 65 66  /ol>..<p> By def
0200: 61 75 6c 74 2c 20 74 68 65 20 53 51 4c 69 74 65  ault, the SQLite
0210: 20 41 6e 64 72 6f 69 64 20 62 69 6e 64 69 6e 67   Android binding
0220: 73 20 73 75 70 70 6f 72 74 20 41 6e 64 72 6f 69  s support Androi
0230: 64 20 41 50 49 20 6c 65 76 65 6c 73 20 31 36 20  d API levels 16 
0240: 0a 61 6e 64 20 67 72 65 61 74 65 72 20 28 41 6e  .and greater (An
0250: 64 72 6f 69 64 20 76 65 72 73 69 6f 6e 73 20 34  droid versions 4
0260: 2e 31 20 61 6e 64 20 75 70 29 2e 20 54 68 65 72  .1 and up). Ther
0270: 65 20 69 73 20 61 6c 73 6f 20 61 20 73 65 70 61  e is also a sepa
0280: 72 61 74 65 20 76 65 72 73 69 6f 6e 0a 74 68 61  rate version.tha
0290: 74 20 73 75 70 70 6f 72 74 73 20 41 6e 64 72 6f  t supports Andro
02a0: 69 64 20 41 50 49 20 6c 65 76 65 6c 73 20 39 20  id API levels 9 
02b0: 61 6e 64 20 67 72 65 61 74 65 72 20 28 41 6e 64  and greater (And
02c0: 72 6f 69 64 20 76 65 72 73 69 6f 6e 20 32 2e 33  roid version 2.3
02d0: 20 61 6e 64 20 0a 75 70 29 2e 20 50 6c 65 61 73   and .up). Pleas
02e0: 65 20 6e 6f 74 65 20 74 68 65 20 65 78 74 72 61  e note the extra
02f0: 20 73 74 65 70 20 69 6e 76 6f 6c 76 65 64 20 69   step involved i
0300: 6e 20 5b 23 6f 62 74 61 69 6e 63 6f 64 65 7c 6f  n [#obtaincode|o
0310: 62 74 61 69 6e 69 6e 67 20 74 68 65 20 63 6f 64  btaining the cod
0320: 65 5d 20 0a 69 66 20 79 6f 75 20 77 69 73 68 20  e] .if you wish 
0330: 74 6f 20 75 73 65 20 74 68 65 20 76 65 72 73 69  to use the versi
0340: 6f 6e 20 63 6f 6d 70 61 74 69 62 6c 65 20 77 69  on compatible wi
0350: 74 68 20 41 50 49 20 6c 65 76 65 6c 20 39 2e 0a  th API level 9..
0360: 0a 3c 68 32 3e 20 3c 61 20 6e 61 6d 65 3d 70 72  .<h2> <a name=pr
0370: 65 62 75 69 6c 74 3e 3c 2f 61 3e 20 31 2e 20 55  ebuilt></a> 1. U
0380: 73 69 6e 67 20 61 20 50 72 65 2d 42 75 69 6c 74  sing a Pre-Built
0390: 20 61 61 72 20 46 69 6c 65 3c 2f 68 32 3e 0a 0a   aar File</h2>..
03a0: 3c 70 3e 0a 20 20 54 68 69 73 20 69 73 20 74 68  <p>.  This is th
03b0: 65 20 6d 6f 73 74 20 73 74 72 61 69 67 68 74 66  e most straightf
03c0: 6f 72 77 61 72 64 20 6f 70 74 69 6f 6e 2e 20 41  orward option. A
03d0: 6e 20 22 61 61 72 22 20 66 69 6c 65 20 69 73 20  n "aar" file is 
03e0: 73 69 6d 69 6c 61 72 20 74 6f 20 61 20 0a 20 20  similar to a .  
03f0: 6a 61 72 20 66 69 6c 65 2c 20 65 78 63 65 70 74  jar file, except
0400: 20 74 68 61 74 20 69 74 20 6d 61 79 20 63 6f 6e   that it may con
0410: 74 61 69 6e 20 62 6f 74 68 20 63 6f 6d 70 69 6c  tain both compil
0420: 65 64 20 6a 61 76 61 20 63 6c 61 73 73 65 73 20  ed java classes 
0430: 61 6e 64 20 0a 20 20 6e 61 74 69 76 65 20 63 6f  and .  native co
0440: 64 65 2e 20 41 6e 20 61 61 72 20 66 69 6c 65 20  de. An aar file 
0450: 66 6f 72 20 74 68 65 20 6c 61 74 65 73 74 20 53  for the latest S
0460: 51 4c 69 74 65 20 72 65 6c 65 61 73 65 20 75 73  QLite release us
0470: 61 62 6c 65 20 77 69 74 68 0a 20 20 41 50 49 20  able with.  API 
0480: 6c 65 76 65 6c 73 20 31 36 20 61 6e 64 20 75 70  levels 16 and up
0490: 20 69 73 20 61 76 61 69 6c 61 62 6c 65 20 66 72   is available fr
04a0: 6f 6d 20 0a 20 20 3c 61 20 68 72 65 66 3d 68 74  om .  <a href=ht
04b0: 74 70 3a 2f 2f 73 71 6c 69 74 65 2e 6f 72 67 2f  tp://sqlite.org/
04c0: 64 6f 77 6e 6c 6f 61 64 2e 68 74 6d 6c 3e 74 68  download.html>th
04d0: 69 73 20 70 61 67 65 3c 2f 61 3e 2e 0a 20 20 0a  is page</a>..  .
04e0: 3c 70 3e 0a 20 20 54 68 65 72 65 20 61 72 65 20  <p>.  There are 
04f0: 74 77 6f 20 73 74 65 70 73 20 69 6e 76 6f 6c 76  two steps involv
0500: 65 64 20 69 6e 20 61 64 64 69 6e 67 20 61 6e 20  ed in adding an 
0510: 61 61 72 20 66 69 6c 65 20 74 6f 20 61 6e 20 41  aar file to an A
0520: 6e 64 72 6f 69 64 20 53 74 75 64 69 6f 0a 20 20  ndroid Studio.  
0530: 70 72 6f 6a 65 63 74 3a 0a 0a 3c 70 3e 0a 20 20  project:..<p>.  
0540: 3c 6f 6c 3e 0a 20 20 20 20 3c 6c 69 3e 20 3c 62  <ol>.    <li> <b
0550: 3e 49 6d 70 6f 72 74 20 74 68 65 20 6d 6f 64 75  >Import the modu
0560: 6c 65 3c 2f 62 3e 2e 20 49 6e 20 41 6e 64 72 6f  le</b>. In Andro
0570: 69 64 20 53 74 75 64 69 6f 20 32 2e 31 20 74 68  id Studio 2.1 th
0580: 69 73 20 69 73 0a 20 20 20 20 61 63 63 6f 6d 70  is is.    accomp
0590: 6c 69 73 68 65 64 20 62 79 20 73 65 6c 65 63 74  lished by select
05a0: 69 6e 67 20 74 68 65 20 3c 63 6f 64 65 3e 22 46  ing the <code>"F
05b0: 69 6c 65 22 20 2d 3e 20 22 4e 65 77 22 20 2d 3e  ile" -> "New" ->
05c0: 20 22 4e 65 77 0a 20 20 20 20 4d 6f 64 75 6c 65   "New.    Module
05d0: 2e 2e 2e 22 3c 2f 63 6f 64 65 3e 20 6d 65 6e 75  ..."</code> menu
05e0: 20 61 6e 64 20 74 68 65 6e 20 63 68 6f 6f 73 69   and then choosi
05f0: 6e 67 20 3c 63 6f 64 65 3e 22 49 6d 70 6f 72 74  ng <code>"Import
0600: 20 4a 41 52 2f 41 41 52 0a 20 20 20 20 50 61 63   JAR/AAR.    Pac
0610: 6b 61 67 65 22 3c 2f 63 6f 64 65 3e 2e 0a 0a 20  kage"</code>... 
0620: 20 20 20 3c 6c 69 3e 20 3c 62 3e 41 64 64 20 61     <li> <b>Add a
0630: 20 64 65 70 65 6e 64 65 6e 63 79 20 6f 6e 20 74   dependency on t
0640: 68 65 20 6e 65 77 20 6d 6f 64 75 6c 65 20 74 6f  he new module to
0650: 20 74 68 65 20 6d 61 69 6e 20 61 70 70 6c 69 63   the main applic
0660: 61 74 69 6f 6e 3c 2f 62 3e 0a 20 20 20 20 6d 6f  ation</b>.    mo
0670: 64 75 6c 65 20 28 6f 72 20 74 6f 20 61 6c 6c 20  dule (or to all 
0680: 6d 6f 64 75 6c 65 73 20 74 68 61 74 20 77 69 6c  modules that wil
0690: 6c 20 75 73 65 20 74 68 65 20 53 51 4c 69 74 65  l use the SQLite
06a0: 20 41 6e 64 72 6f 69 64 20 62 69 6e 64 69 6e 67   Android binding
06b0: 73 29 2e 20 20 49 6e 0a 20 20 20 20 41 6e 64 72  s).  In.    Andr
06c0: 6f 69 64 20 53 74 75 64 69 6f 20 32 2e 31 20 74  oid Studio 2.1 t
06d0: 68 65 20 64 65 70 65 6e 64 65 6e 63 79 20 6d 61  he dependency ma
06e0: 79 20 62 65 20 63 72 65 61 74 65 64 20 75 73 69  y be created usi
06f0: 6e 67 20 74 68 65 20 70 72 6f 6a 65 63 74 0a 20  ng the project. 
0700: 20 20 20 73 74 72 75 63 74 75 72 65 20 64 69 61     structure dia
0710: 6c 6f 67 20 28 73 65 6c 65 63 74 20 3c 63 6f 64  log (select <cod
0720: 65 3e 22 46 69 6c 65 22 20 2d 3e 20 22 50 72 6f  e>"File" -> "Pro
0730: 6a 65 63 74 20 53 74 72 75 63 74 75 72 65 2e 2e  ject Structure..
0740: 2e 22 3c 2f 63 6f 64 65 3e 29 20 6f 72 0a 20 20  ."</code>) or.  
0750: 20 20 62 79 20 61 64 64 69 6e 67 20 63 6f 64 65    by adding code
0760: 20 73 69 6d 69 6c 61 72 20 74 6f 20 74 68 65 20   similar to the 
0770: 66 6f 6c 6c 6f 77 69 6e 67 20 74 6f 20 74 68 65  following to the
0780: 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 6d 6f 64   application mod
0790: 75 6c 65 73 0a 20 20 20 20 3c 63 6f 64 65 3e 62  ules.    <code>b
07a0: 75 69 6c 64 2e 67 72 61 64 6c 65 3c 2f 63 6f 64  uild.gradle</cod
07b0: 65 3e 20 66 69 6c 65 3a 20 3c 76 65 72 62 61 74  e> file: <verbat
07c0: 69 6d 3e 0a 20 20 20 20 64 65 70 65 6e 64 65 6e  im>.    dependen
07d0: 63 69 65 73 20 7b 0a 20 20 20 20 20 20 20 20 2f  cies {.        /
07e0: 2f 20 43 68 61 6e 67 65 20 22 73 71 6c 69 74 65  / Change "sqlite
07f0: 2d 61 6e 64 72 6f 69 64 2d 33 31 33 30 30 30 30  -android-3130000
0800: 22 20 74 6f 20 74 68 65 20 6e 61 6d 65 20 6f 66  " to the name of
0810: 20 74 68 65 20 6e 65 77 20 6d 6f 64 75 6c 65 21   the new module!
0820: 0a 20 20 20 20 20 20 20 20 63 6f 6d 70 69 6c 65  .        compile
0830: 20 70 72 6f 6a 65 63 74 28 27 3a 73 71 6c 69 74   project(':sqlit
0840: 65 2d 61 6e 64 72 6f 69 64 2d 33 31 33 30 30 30  e-android-313000
0850: 30 27 29 0a 20 20 20 20 7d 3c 2f 76 65 72 62 61  0').    }</verba
0860: 74 69 6d 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 20  tim>.</ol>..<p> 
0870: 41 20 6d 6f 72 65 20 64 65 74 61 69 6c 65 64 20  A more detailed 
0880: 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 75  description of u
0890: 73 69 6e 67 20 74 68 65 20 73 74 65 70 73 20 61  sing the steps a
08a0: 62 6f 76 65 20 74 6f 20 63 72 65 61 74 65 20 61  bove to create a
08b0: 20 76 65 72 79 20 0a 20 20 20 20 73 69 6d 70 6c   very .    simpl
08c0: 65 20 61 70 70 6c 69 63 74 61 74 69 6f 6e 20 69  e applictation i
08d0: 73 20 5b 2e 2f 76 65 72 79 73 69 6d 70 6c 65 61  s [./verysimplea
08e0: 70 70 2e 77 69 6b 69 20 7c 20 61 76 61 69 6c 61  pp.wiki | availa
08f0: 62 6c 65 20 68 65 72 65 5d 2e 0a 0a 3c 70 3e 0a  ble here]...<p>.
0900: 20 20 41 74 20 74 69 6d 65 20 6f 66 20 77 72 69    At time of wri
0910: 74 69 6e 67 2c 20 61 61 72 20 66 69 6c 65 73 20  ting, aar files 
0920: 6d 61 79 20 6f 6e 6c 79 20 62 65 20 75 73 65 64  may only be used
0930: 20 64 69 72 65 63 74 6c 79 20 69 6e 20 41 6e 64   directly in And
0940: 72 6f 69 64 20 53 74 75 64 69 6f 0a 20 20 70 72  roid Studio.  pr
0950: 6f 6a 65 63 74 73 2c 20 6e 6f 74 20 70 72 6f 6a  ojects, not proj
0960: 65 63 74 73 20 63 72 65 61 74 65 64 20 75 73 69  ects created usi
0970: 6e 67 20 6f 74 68 65 72 20 49 44 45 73 20 28 65  ng other IDEs (e
0980: 2e 67 2e 20 45 63 6c 69 70 73 65 2c 20 49 6e 74  .g. Eclipse, Int
0990: 65 6c 6c 69 4a 0a 20 20 49 44 45 41 29 2e 20 48  elliJ.  IDEA). H
09a0: 6f 77 65 76 65 72 2c 20 61 6e 20 61 61 72 20 69  owever, an aar i
09b0: 73 20 6a 75 73 74 20 61 20 7a 69 70 20 61 72 63  s just a zip arc
09c0: 68 69 76 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20  hive containing 
09d0: 61 0a 20 20 3c 63 6f 64 65 3e 63 6c 61 73 73 65  a.  <code>classe
09e0: 73 2e 6a 61 72 3c 2f 63 6f 64 65 3e 20 66 69 6c  s.jar</code> fil
09f0: 65 20 74 68 61 74 20 69 6e 20 74 75 72 6e 20 63  e that in turn c
0a00: 6f 6e 74 61 69 6e 73 20 74 68 65 20 53 51 4c 69  ontains the SQLi
0a10: 74 65 20 41 6e 64 72 6f 69 64 0a 20 20 62 69 6e  te Android.  bin
0a20: 64 69 6e 67 20 6a 61 76 61 20 63 6c 61 73 73 65  ding java classe
0a30: 73 20 61 6e 64 20 61 20 3c 63 6f 64 65 3e 6a 6e  s and a <code>jn
0a40: 69 2f 3c 2f 63 6f 64 65 3e 20 64 69 72 65 63 74  i/</code> direct
0a50: 6f 72 79 20 74 68 61 74 20 63 6f 6e 74 61 69 6e  ory that contain
0a60: 73 20 74 68 65 20 0a 20 20 6e 61 74 69 76 65 20  s the .  native 
0a70: 6c 69 62 72 61 72 79 20 66 6f 72 20 65 61 63 68  library for each
0a80: 20 70 6c 61 74 66 6f 72 6d 2e 20 20 42 79 20 65   platform.  By e
0a90: 78 74 72 61 63 74 69 6e 67 20 74 68 65 73 65 20  xtracting these 
0aa0: 74 77 6f 20 74 68 69 6e 67 73 20 66 72 6f 6d 20  two things from 
0ab0: 74 68 65 20 0a 20 20 61 61 72 20 66 69 6c 65 20  the .  aar file 
0ac0: 61 6e 64 20 61 64 64 69 6e 67 20 74 68 65 6d 20  and adding them 
0ad0: 74 6f 20 74 68 65 20 70 72 6f 6a 65 63 74 20 73  to the project s
0ae0: 65 70 61 72 61 74 65 6c 79 20 69 74 20 69 73 20  eparately it is 
0af0: 6f 66 74 65 6e 20 70 6f 73 73 69 62 6c 65 20 74  often possible t
0b00: 6f 20 0a 20 20 75 73 65 20 61 6e 20 61 61 72 20  o .  use an aar 
0b10: 66 69 6c 65 20 69 6e 20 6e 6f 6e 2d 41 6e 64 72  file in non-Andr
0b20: 6f 69 64 20 53 74 75 64 69 6f 20 70 72 6f 6a 65  oid Studio proje
0b30: 63 74 73 2e 0a 0a 3c 68 32 3e 32 2e 20 3c 61 20  cts...<h2>2. <a 
0b40: 6e 61 6d 65 3d 63 75 73 74 6f 6d 61 61 72 3e 3c  name=customaar><
0b50: 2f 61 3e 20 42 75 69 6c 64 69 6e 67 20 61 20 43  /a> Building a C
0b60: 75 73 74 6f 6d 20 61 61 72 20 46 69 6c 65 3c 2f  ustom aar File</
0b70: 68 32 3e 0a 0a 3c 70 3e 0a 20 20 42 75 69 6c 64  h2>..<p>.  Build
0b80: 69 6e 67 20 61 20 63 75 73 74 6f 6d 20 61 61 72  ing a custom aar
0b90: 20 66 69 6c 65 20 72 65 71 75 69 72 65 73 20 62   file requires b
0ba0: 6f 74 68 20 74 68 65 20 41 6e 64 72 6f 69 64 20  oth the Android 
0bb0: 53 44 4b 20 61 6e 64 20 4e 44 4b 2e 20 0a 0a 3c  SDK and NDK. ..<
0bc0: 6f 6c 3e 0a 20 20 3c 6c 69 3e 3c 61 20 6e 61 6d  ol>.  <li><a nam
0bd0: 65 3d 6f 62 74 61 69 6e 63 6f 64 65 3e 3c 2f 61  e=obtaincode></a
0be0: 3e 3c 62 3e 4f 62 74 61 69 6e 20 74 68 65 20 63  ><b>Obtain the c
0bf0: 6f 64 65 3c 2f 62 3e 2e 20 54 68 65 20 63 6f 64  ode</b>. The cod
0c00: 65 20 66 6f 72 20 74 68 65 20 53 51 4c 69 74 65  e for the SQLite
0c10: 20 41 6e 64 72 6f 69 64 20 62 69 6e 64 69 6e 67   Android binding
0c20: 73 20 6d 61 79 0a 20 20 62 65 20 6f 62 74 61 69  s may.  be obtai
0c30: 6e 65 64 20 65 69 74 68 65 72 20 62 79 20 63 68  ned either by ch
0c40: 65 63 6b 69 6e 67 20 6f 75 74 20 0a 20 20 74 68  ecking out .  th
0c50: 65 20 3c 61 20 68 72 65 66 3d 68 74 74 70 3a 2f  e <a href=http:/
0c60: 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 3e  /fossil-scm.org>
0c70: 66 6f 73 73 69 6c 3c 2f 61 3e 20 72 65 70 6f 73  fossil</a> repos
0c80: 69 74 6f 72 79 2c 20 6f 72 20 62 79 20 64 6f 77  itory, or by dow
0c90: 6e 6c 6f 61 64 69 6e 67 0a 20 20 61 20 7a 69 70  nloading.  a zip
0ca0: 20 66 69 6c 65 2e 0a 20 20 3c 70 3e 0a 20 20 54   file..  <p>.  T
0cb0: 6f 20 6f 62 74 61 69 6e 20 74 68 65 20 63 6f 64  o obtain the cod
0cc0: 65 20 75 73 69 6e 67 20 66 6f 73 73 69 6c 2c 20  e using fossil, 
0cd0: 75 73 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  use the followin
0ce0: 67 20 73 65 72 69 65 73 20 6f 66 20 63 6f 6d 6d  g series of comm
0cf0: 61 6e 64 73 2e 0a 20 20 49 6e 20 74 68 69 73 20  ands..  In this 
0d00: 63 61 73 65 2c 20 74 68 65 20 22 70 72 6f 6a 65  case, the "proje
0d10: 63 74 20 64 69 72 65 63 74 6f 72 79 22 20 72 65  ct directory" re
0d20: 66 65 72 65 64 20 74 6f 20 69 6e 20 73 75 62 73  fered to in subs
0d30: 65 71 75 65 6e 74 20 73 74 65 70 73 20 69 73 0a  equent steps is.
0d40: 20 20 74 68 65 20 3c 63 6f 64 65 3e 73 71 6c 69    the <code>sqli
0d50: 74 65 3c 2f 63 6f 64 65 3e 20 64 69 72 65 63 74  te</code> direct
0d60: 6f 72 79 20 63 72 65 61 74 65 64 20 62 79 20 74  ory created by t
0d70: 68 65 20 73 65 63 6f 6e 64 20 63 6f 6d 6d 61 6e  he second comman
0d80: 64 20 62 65 6c 6f 77 3a 0a 20 20 3c 70 3e 0a 20  d below:.  <p>. 
0d90: 20 3c 76 65 72 62 61 74 69 6d 3e 0a 20 20 20 20   <verbatim>.    
0da0: 24 20 66 6f 73 73 69 6c 20 63 6c 6f 6e 65 20 68  $ fossil clone h
0db0: 74 74 70 3a 2f 2f 77 77 77 2e 73 71 6c 69 74 65  ttp://www.sqlite
0dc0: 2e 6f 72 67 2f 61 6e 64 72 6f 69 64 20 61 6e 64  .org/android and
0dd0: 72 6f 69 64 2e 66 6f 73 73 69 6c 0a 20 20 20 20  roid.fossil.    
0de0: 24 20 6d 6b 64 69 72 20 73 71 6c 69 74 65 0a 20  $ mkdir sqlite. 
0df0: 20 20 20 24 20 63 64 20 73 71 6c 69 74 65 0a 20     $ cd sqlite. 
0e00: 20 20 20 24 20 66 6f 73 73 69 6c 20 6f 70 65 6e     $ fossil open
0e10: 20 2e 2e 2f 61 6e 64 72 6f 69 64 2e 66 6f 73 73   ../android.foss
0e20: 69 6c 3c 2f 76 65 72 62 61 74 69 6d 3e 0a 20 20  il</verbatim>.  
0e30: 3c 70 3e 0a 20 20 41 6c 74 65 72 6e 61 74 69 76  <p>.  Alternativ
0e40: 65 6c 79 2c 20 74 68 65 20 6c 61 74 65 73 74 20  ely, the latest 
0e50: 63 6f 64 65 20 6d 61 79 20 62 65 20 64 6f 77 6e  code may be down
0e60: 6c 6f 61 64 65 64 20 61 73 20 61 20 0a 20 20 3c  loaded as a .  <
0e70: 61 20 68 72 65 66 3d 68 74 74 70 3a 2f 2f 77 77  a href=http://ww
0e80: 77 2e 73 71 6c 69 74 65 2e 6f 72 67 2f 61 6e 64  w.sqlite.org/and
0e90: 72 6f 69 64 2f 7a 69 70 2f 53 51 4c 69 74 65 2b  roid/zip/SQLite+
0ea0: 41 6e 64 72 6f 69 64 2b 42 69 6e 64 69 6e 67 73  Android+Bindings
0eb0: 2e 7a 69 70 3f 75 75 69 64 3d 74 72 75 6e 6b 3e  .zip?uuid=trunk>
0ec0: 7a 69 70 20 61 72 63 68 69 76 65 3c 2f 61 3e 2e  zip archive</a>.
0ed0: 20 0a 20 20 49 6e 20 74 68 69 73 20 63 61 73 65   .  In this case
0ee0: 2c 20 74 68 65 20 22 70 72 6f 6a 65 63 74 20 64  , the "project d
0ef0: 69 72 65 63 74 6f 72 79 22 20 69 73 20 74 68 65  irectory" is the
0f00: 0a 20 20 3c 63 6f 64 65 3e 53 51 4c 69 74 65 5f  .  <code>SQLite_
0f10: 41 6e 64 72 6f 69 64 5f 42 69 6e 64 69 6e 67 73  Android_Bindings
0f20: 2f 3c 2f 63 6f 64 65 3e 20 64 69 72 65 63 74 6f  /</code> directo
0f30: 72 79 20 63 72 65 61 74 65 64 20 62 79 20 75 6e  ry created by un
0f40: 7a 69 70 70 69 6e 67 20 74 68 65 0a 20 20 64 6f  zipping the.  do
0f50: 77 6e 6c 6f 61 64 65 64 20 61 72 63 68 69 76 65  wnloaded archive
0f60: 2e 0a 20 20 3c 70 3e 0a 20 20 3c 69 3e 41 50 49  ..  <p>.  <i>API
0f70: 20 6c 65 76 65 6c 20 39 2d 31 35 20 75 73 65 72   level 9-15 user
0f80: 73 3a 3c 2f 69 3e 20 54 68 65 20 63 6f 64 65 20  s:</i> The code 
0f90: 66 6f 72 20 74 68 65 20 76 65 72 73 69 6f 6e 20  for the version 
0fa0: 74 68 61 74 20 69 73 0a 20 20 63 6f 6d 70 61 74  that is.  compat
0fb0: 69 62 6c 65 20 77 69 74 68 20 41 6e 64 72 6f 69  ible with Androi
0fc0: 64 20 41 50 49 20 6c 65 76 65 6c 20 39 20 61 6e  d API level 9 an
0fd0: 64 20 67 72 65 61 74 65 72 20 6d 61 79 20 62 65  d greater may be
0fe0: 20 6f 62 74 61 69 6e 65 64 20 61 73 20 61 20 7a   obtained as a z
0ff0: 69 70 0a 20 20 66 69 6c 65 20 0a 20 20 3c 61 20  ip.  file .  <a 
1000: 68 72 65 66 3d 68 74 74 70 3a 2f 2f 77 77 77 2e  href=http://www.
1010: 73 71 6c 69 74 65 2e 6f 72 67 2f 61 6e 64 72 6f  sqlite.org/andro
1020: 69 64 2f 7a 69 70 2f 53 51 4c 69 74 65 2b 41 6e  id/zip/SQLite+An
1030: 64 72 6f 69 64 2b 42 69 6e 64 69 6e 67 73 2e 7a  droid+Bindings.z
1040: 69 70 3f 75 75 69 64 3d 61 70 69 2d 6c 65 76 65  ip?uuid=api-leve
1050: 6c 2d 39 3e 66 72 6f 6d 20 68 65 72 65 3c 2f 61  l-9>from here</a
1060: 3e 2e 0a 20 20 4f 72 2c 20 69 66 20 75 73 69 6e  >..  Or, if usin
1070: 67 20 66 6f 73 73 69 6c 2c 20 74 68 65 20 3c 63  g fossil, the <c
1080: 6f 64 65 3e 66 6f 73 73 69 6c 20 6f 70 65 6e 3c  ode>fossil open<
1090: 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 20 61  /code> command a
10a0: 62 6f 76 65 20 73 68 6f 75 6c 64 20 62 65 0a 20  bove should be. 
10b0: 20 72 65 70 6c 61 63 65 64 20 77 69 74 68 3a 20   replaced with: 
10c0: 0a 20 20 3c 76 65 72 62 61 74 69 6d 3e 0a 20 20  .  <verbatim>.  
10d0: 20 20 24 20 66 6f 73 73 69 6c 20 6f 70 65 6e 20    $ fossil open 
10e0: 2e 2e 2f 61 6e 64 72 6f 69 64 2e 66 6f 73 73 69  ../android.fossi
10f0: 6c 20 61 70 69 2d 6c 65 76 65 6c 2d 39 3c 2f 76  l api-level-9</v
1100: 65 72 62 61 74 69 6d 3e 0a 0a 20 20 3c 6c 69 3e  erbatim>..  <li>
1110: 3c 61 20 6e 61 6d 65 3d 62 75 69 6c 64 6e 61 74  <a name=buildnat
1120: 69 76 65 3e 3c 2f 61 3e 20 3c 62 3e 43 6f 6e 66  ive></a> <b>Conf
1130: 69 67 75 72 65 20 74 68 65 20 6e 61 74 69 76 65  igure the native
1140: 20 6c 69 62 72 61 72 69 65 73 2e 3c 2f 62 3e 0a   libraries.</b>.
1150: 20 20 3c 70 3e 20 0a 20 20 54 68 65 20 6c 61 74    <p> .  The lat
1160: 65 73 74 20 72 65 6c 65 61 73 65 20 6f 66 20 74  est release of t
1170: 68 65 20 70 75 62 6c 69 63 20 64 6f 6d 61 69 6e  he public domain
1180: 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20   SQLite library 
1190: 69 73 20 62 75 6e 64 6c 65 64 20 0a 20 20 77 69  is bundled .  wi
11a0: 74 68 20 74 68 65 20 53 51 4c 69 74 65 20 41 6e  th the SQLite An
11b0: 64 72 6f 69 64 20 62 69 6e 64 69 6e 67 73 20 63  droid bindings c
11c0: 6f 64 65 20 64 6f 77 6e 6c 6f 61 64 65 64 20 69  ode downloaded i
11d0: 6e 20 73 74 65 70 20 31 2e 20 49 66 20 79 6f 75  n step 1. If you
11e0: 20 77 69 73 68 0a 20 20 74 6f 20 75 73 65 20 61   wish.  to use a
11f0: 20 64 69 66 66 65 72 65 6e 74 20 76 65 72 73 69   different versi
1200: 6f 6e 20 6f 66 20 53 51 4c 69 74 65 2c 20 66 6f  on of SQLite, fo
1210: 72 20 65 78 61 6d 70 6c 65 20 6f 6e 65 20 74 68  r example one th
1220: 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 0a  at contains the.
1230: 20 20 70 72 6f 70 72 69 65 74 72 79 20 5b 2e 2f    proprietry [./
1240: 73 65 65 2e 77 69 6b 69 20 7c 20 53 45 45 20 65  see.wiki | SEE e
1250: 78 74 65 6e 73 69 6f 6e 5d 2c 20 74 68 65 6e 20  xtension], then 
1260: 72 65 70 6c 61 63 65 20 74 68 65 20 3c 63 6f 64  replace the <cod
1270: 65 3e 73 71 6c 69 74 65 33 2e 63 3c 2f 63 6f 64  e>sqlite3.c</cod
1280: 65 3e 0a 20 20 61 6e 64 20 3c 63 6f 64 65 3e 73  e>.  and <code>s
1290: 71 6c 69 74 65 33 2e 68 3c 2f 63 6f 64 65 3e 20  qlite3.h</code> 
12a0: 66 69 6c 65 73 20 61 74 20 74 68 65 20 66 6f 6c  files at the fol
12b0: 6c 6f 77 69 6e 67 20 6c 6f 63 61 74 69 6f 6e 73  lowing locations
12c0: 3a 0a 3c 76 65 72 62 61 74 69 6d 3e 0a 20 20 20  :.<verbatim>.   
12d0: 20 73 71 6c 69 74 65 33 2f 73 72 63 2f 6d 61 69   sqlite3/src/mai
12e0: 6e 2f 6a 6e 69 2f 73 71 6c 69 74 65 2f 73 71 6c  n/jni/sqlite/sql
12f0: 69 74 65 33 2e 63 0a 20 20 20 20 73 71 6c 69 74  ite3.c.    sqlit
1300: 65 33 2f 73 72 63 2f 6d 61 69 6e 2f 6a 6e 69 2f  e3/src/main/jni/
1310: 73 71 6c 69 74 65 2f 73 71 6c 69 74 65 33 2e 68  sqlite/sqlite3.h
1320: 3c 2f 76 65 72 62 61 74 69 6d 3e 0a 20 20 3c 70  </verbatim>.  <p
1330: 3e 20 0a 20 20 42 79 20 64 65 66 61 75 6c 74 2c  > .  By default,
1340: 20 53 51 4c 69 74 65 20 69 73 20 62 75 69 6c 74   SQLite is built
1350: 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77   with the follow
1360: 69 6e 67 20 6f 70 74 69 6f 6e 73 3a 0a 3c 76 65  ing options:.<ve
1370: 72 62 61 74 69 6d 3e 0a 20 20 20 20 2d 44 53 51  rbatim>.    -DSQ
1380: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 35  LITE_ENABLE_FTS5
1390: 0a 20 20 20 20 2d 44 53 51 4c 49 54 45 5f 45 4e  .    -DSQLITE_EN
13a0: 41 42 4c 45 5f 52 54 52 45 45 0a 20 20 20 20 2d  ABLE_RTREE.    -
13b0: 44 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4a  DSQLITE_ENABLE_J
13c0: 53 4f 4e 31 0a 20 20 20 20 2d 44 53 51 4c 49 54  SON1.    -DSQLIT
13d0: 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 3c 2f 76  E_ENABLE_FTS3</v
13e0: 65 72 62 61 74 69 6d 3e 0a 20 20 54 6f 20 62 75  erbatim>.  To bu
13f0: 69 6c 64 20 74 68 65 20 53 51 4c 69 74 65 20 6c  ild the SQLite l
1400: 69 62 72 61 72 79 20 77 69 74 68 20 73 6f 6d 65  ibrary with some
1410: 20 6f 74 68 65 72 20 63 6f 6d 62 69 6e 61 74 69   other combinati
1420: 6f 6e 20 6f 66 20 63 6f 6d 6d 61 6e 64 20 6c 69  on of command li
1430: 6e 65 0a 20 20 73 77 69 74 63 68 65 73 2c 20 65  ne.  switches, e
1440: 64 69 74 20 74 68 65 20 3c 63 6f 64 65 3e 41 6e  dit the <code>An
1450: 64 72 6f 69 64 2e 6d 6b 3c 2f 63 6f 64 65 3e 20  droid.mk</code> 
1460: 66 69 6c 65 20 61 74 20 74 68 69 73 20 6c 6f 63  file at this loc
1470: 61 74 69 6f 6e 3a 0a 3c 76 65 72 62 61 74 69 6d  ation:.<verbatim
1480: 3e 0a 20 20 20 20 73 71 6c 69 74 65 33 2f 73 72  >.    sqlite3/sr
1490: 63 2f 6d 61 69 6e 2f 6a 6e 69 2f 73 71 6c 69 74  c/main/jni/sqlit
14a0: 65 2f 41 6e 64 72 6f 69 64 2e 6d 6b 3c 2f 76 65  e/Android.mk</ve
14b0: 72 62 61 74 69 6d 3e 0a 0a 3c 6c 69 3e 3c 61 20  rbatim>..<li><a 
14c0: 6e 61 6d 65 3d 62 75 69 6c 64 6e 61 74 69 76 65  name=buildnative
14d0: 32 3e 3c 2f 61 3e 20 3c 62 3e 42 75 69 6c 64 20  2></a> <b>Build 
14e0: 74 68 65 20 6e 61 74 69 76 65 20 6c 69 62 72 61  the native libra
14f0: 72 69 65 73 2e 3c 2f 62 3e 0a 3c 70 3e 0a 54 68  ries.</b>.<p>.Th
1500: 69 73 20 73 74 65 70 20 69 73 20 3c 62 3e 6f 70  is step is <b>op
1510: 74 69 6f 6e 61 6c 2e 20 49 74 20 77 69 6c 6c 20  tional. It will 
1520: 62 65 20 72 75 6e 20 61 75 74 6f 6d 61 74 69 63  be run automatic
1530: 61 6c 6c 79 20 62 79 20 74 68 65 0a 3c 2f 62 3e  ally by the.</b>
1540: 3c 63 6f 64 65 3e 67 72 61 64 6c 65 77 3c 2f 63  <code>gradlew</c
1550: 6f 64 65 3e 3c 62 3e 20 63 6f 6d 6d 61 6e 64 20  ode><b> command 
1560: 69 6e 20 73 74 65 70 20 34 2e 3c 2f 62 3e 20 52  in step 4.</b> R
1570: 75 6e 6e 69 6e 67 20 69 74 20 73 65 70 61 72 61  unning it separa
1580: 74 65 6c 79 0a 69 73 20 70 72 69 6d 61 72 69 6c  tely.is primaril
1590: 79 20 75 73 65 66 75 6c 20 66 6f 72 20 66 6f 72  y useful for for
15a0: 20 64 65 62 75 67 67 69 6e 67 20 62 72 6f 6b 65   debugging broke
15b0: 6e 20 62 75 69 6c 64 73 2e 0a 20 20 3c 70 3e 20  n builds..  <p> 
15c0: 54 6f 20 62 75 69 6c 64 20 74 68 65 20 6e 61 74  To build the nat
15d0: 69 76 65 20 6c 69 62 72 61 72 69 65 73 2c 20 6e  ive libraries, n
15e0: 61 76 69 67 61 74 65 20 74 6f 20 74 68 65 0a 20  avigate to the. 
15f0: 20 20 20 20 20 3c 63 6f 64 65 3e 73 71 6c 69 74       <code>sqlit
1600: 65 33 2f 73 72 63 2f 6d 61 69 6e 2f 3c 2f 63 6f  e3/src/main/</co
1610: 64 65 3e 20 64 69 72 65 63 74 6f 72 79 20 6f 66  de> directory of
1620: 20 74 68 65 20 70 72 6f 6a 65 63 74 20 64 69 72   the project dir
1630: 65 63 74 6f 72 79 20 61 6e 64 0a 20 20 20 20 20  ectory and.     
1640: 20 72 75 6e 20 74 68 65 20 3c 63 6f 64 65 3e 6e   run the <code>n
1650: 64 6b 2d 62 75 69 6c 64 3c 2f 63 6f 64 65 3e 20  dk-build</code> 
1660: 63 6f 6d 6d 61 6e 64 2e 20 46 6f 72 20 65 78 61  command. For exa
1670: 6d 70 6c 65 2c 20 6f 6e 20 4c 69 6e 75 78 20 69  mple, on Linux i
1680: 66 20 0a 20 20 20 20 20 20 41 6e 64 72 6f 69 64  f .      Android
1690: 20 53 74 75 64 69 6f 20 61 6e 64 20 74 68 65 20   Studio and the 
16a0: 4e 44 4b 20 61 72 65 20 69 6e 73 74 61 6c 6c 65  NDK are installe
16b0: 64 20 75 73 69 6e 67 20 74 68 65 69 72 20 64 65  d using their de
16c0: 66 61 75 6c 74 20 70 61 74 68 73 3a 0a 3c 76 65  fault paths:.<ve
16d0: 72 62 61 74 69 6d 3e 0a 20 20 20 20 24 20 63 64  rbatim>.    $ cd
16e0: 20 73 71 6c 69 74 65 33 2f 73 72 63 2f 6d 61 69   sqlite3/src/mai
16f0: 6e 0a 20 20 20 20 24 20 7e 2f 41 6e 64 72 6f 69  n.    $ ~/Androi
1700: 64 2f 53 64 6b 2f 6e 64 6b 2d 62 75 6e 64 6c 65  d/Sdk/ndk-bundle
1710: 2f 6e 64 6b 2d 62 75 69 6c 64 3c 2f 76 65 72 62  /ndk-build</verb
1720: 61 74 69 6d 3e 0a 20 20 3c 70 3e 20 4f 6e 20 6d  atim>.  <p> On m
1730: 6f 64 65 72 6e 20 68 61 72 64 77 61 72 65 2c 20  odern hardware, 
1740: 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 74 61 6b  this command tak
1750: 65 73 20 72 6f 75 67 68 6c 79 20 33 20 6d 69 6e  es roughly 3 min
1760: 75 74 65 73 20 74 6f 20 62 75 69 6c 64 20 74 68  utes to build th
1770: 65 0a 20 20 20 20 20 20 6e 61 74 69 76 65 20 6c  e.      native l
1780: 69 62 72 61 72 69 65 73 20 66 6f 72 20 61 6c 6c  ibraries for all
1790: 20 41 6e 64 72 6f 69 64 20 61 72 63 68 69 74 65   Android archite
17a0: 63 74 75 72 65 73 2e 0a 20 20 3c 70 3e 0a 20 20  ctures..  <p>.  
17b0: 49 66 20 74 68 65 20 3c 63 6f 64 65 3e 41 6e 64  If the <code>And
17c0: 72 6f 69 64 2e 6d 6b 3c 2f 63 6f 64 65 3e 20 66  roid.mk</code> f
17d0: 69 6c 65 20 69 73 20 65 64 69 74 65 64 20 61 66  ile is edited af
17e0: 74 65 72 20 3c 63 6f 64 65 3e 6e 64 6b 2d 62 75  ter <code>ndk-bu
17f0: 69 6c 64 3c 2f 63 6f 64 65 3e 20 69 73 0a 20 20  ild</code> is.  
1800: 72 75 6e 2c 20 69 74 20 6d 61 79 20 62 65 20 6e  run, it may be n
1810: 65 63 65 73 73 61 72 79 20 74 6f 20 72 75 6e 20  ecessary to run 
1820: 74 68 65 20 3c 63 6f 64 65 3e 6e 64 6b 2d 62 75  the <code>ndk-bu
1830: 69 6c 64 20 63 6c 65 61 6e 3c 2f 63 6f 64 65 3e  ild clean</code>
1840: 20 63 6f 6d 6d 61 6e 64 0a 20 20 62 65 66 6f 72   command.  befor
1850: 65 20 72 65 72 75 6e 6e 69 6e 67 20 3c 63 6f 64  e rerunning <cod
1860: 65 3e 6e 64 6b 2d 62 75 69 6c 64 3c 2f 63 6f 64  e>ndk-build</cod
1870: 65 3e 20 74 6f 20 65 6e 73 75 72 65 20 61 20 63  e> to ensure a c
1880: 6f 72 72 65 63 74 20 62 75 69 6c 64 2e 0a 0a 20  orrect build... 
1890: 20 3c 6c 69 3e 20 3c 62 3e 41 73 73 65 6d 62 6c   <li> <b>Assembl
18a0: 65 20 74 68 65 20 61 61 72 20 66 69 6c 65 3c 2f  e the aar file</
18b0: 62 3e 2e 20 54 6f 20 61 73 73 65 6d 62 6c 65 20  b>. To assemble 
18c0: 74 68 65 20 61 61 72 20 66 69 6c 65 20 75 73 69  the aar file usi
18d0: 6e 67 20 74 68 65 20 0a 20 20 63 6f 6d 6d 61 6e  ng the .  comman
18e0: 64 20 6c 69 6e 65 2c 20 66 69 72 73 74 20 73 65  d line, first se
18f0: 74 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61  t environment va
1900: 72 69 61 62 6c 65 20 41 4e 44 52 4f 49 44 5f 48  riable ANDROID_H
1910: 4f 4d 45 20 74 6f 20 74 68 65 20 53 44 4b 0a 20  OME to the SDK. 
1920: 20 64 69 72 65 63 74 6f 72 79 2c 20 74 68 65 6e   directory, then
1930: 20 72 75 6e 20 74 68 65 20 67 72 61 64 6c 65 20   run the gradle 
1940: 22 61 73 73 65 6d 62 6c 65 52 65 6c 65 61 73 65  "assembleRelease
1950: 22 20 74 61 72 67 65 74 20 66 72 6f 6d 20 77 69  " target from wi
1960: 74 68 69 6e 20 74 68 65 0a 20 20 22 73 71 6c 69  thin the.  "sqli
1970: 74 65 33 22 20 73 75 62 2d 64 69 72 65 63 74 6f  te3" sub-directo
1980: 72 79 20 6f 66 20 74 68 65 20 70 72 6f 6a 65 63  ry of the projec
1990: 74 20 64 69 72 65 63 74 6f 72 79 2e 20 46 6f 72  t directory. For
19a0: 20 65 78 61 6d 70 6c 65 3a 0a 3c 76 65 72 62 61   example:.<verba
19b0: 74 69 6d 3e 0a 20 20 20 20 24 20 65 78 70 6f 72  tim>.    $ expor
19c0: 74 20 41 4e 44 52 4f 49 44 5f 48 4f 4d 45 3d 7e  t ANDROID_HOME=~
19d0: 2f 41 6e 64 72 6f 69 64 2f 53 64 6b 2f 0a 20 20  /Android/Sdk/.  
19e0: 20 20 24 20 63 64 20 73 71 6c 69 74 65 33 0a 20    $ cd sqlite3. 
19f0: 20 20 20 24 20 2e 2e 2f 67 72 61 64 6c 65 77 20     $ ../gradlew 
1a00: 61 73 73 65 6d 62 6c 65 52 65 6c 65 61 73 65 3c  assembleRelease<
1a10: 2f 76 65 72 62 61 74 69 6d 3e 0a 20 20 3c 70 3e  /verbatim>.  <p>
1a20: 0a 20 20 41 73 73 65 6d 62 6c 69 6e 67 20 61 6e  .  Assembling an
1a30: 20 61 61 72 20 66 69 6c 65 20 75 73 69 6e 67 20   aar file using 
1a40: 41 6e 64 72 6f 69 64 20 53 74 75 64 69 6f 20 69  Android Studio i
1a50: 73 20 73 69 6d 69 6c 61 72 2e 20 4f 70 65 6e 20  s similar. Open 
1a60: 74 68 65 20 53 51 4c 69 74 65 0a 20 20 41 6e 64  the SQLite.  And
1a70: 72 6f 69 64 20 62 69 6e 64 69 6e 67 73 20 70 72  roid bindings pr
1a80: 6f 6a 65 63 74 20 75 73 69 6e 67 20 41 6e 64 72  oject using Andr
1a90: 6f 69 64 20 53 74 75 64 69 6f 2c 20 72 75 6e 20  oid Studio, run 
1aa0: 61 20 22 67 72 61 64 6c 65 20 73 79 6e 63 22 2c  a "gradle sync",
1ab0: 20 74 68 65 6e 0a 20 20 72 75 6e 20 74 68 65 20   then.  run the 
1ac0: 22 61 73 73 65 6d 62 6c 65 52 65 6c 65 61 73 65  "assembleRelease
1ad0: 22 20 67 72 61 64 6c 65 20 74 61 73 6b 20 77 69  " gradle task wi
1ae0: 74 68 69 6e 20 74 68 65 20 22 73 71 6c 69 74 65  thin the "sqlite
1af0: 33 22 20 6d 6f 64 75 6c 65 2e 0a 20 20 3c 70 3e  3" module..  <p>
1b00: 0a 20 20 55 73 69 6e 67 20 65 69 74 68 65 72 20  .  Using either 
1b10: 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65  the command line
1b20: 20 6f 72 20 41 6e 64 72 6f 69 64 20 53 74 75 64   or Android Stud
1b30: 69 6f 20 74 6f 20 72 75 6e 20 74 68 65 20 67 72  io to run the gr
1b40: 61 64 6c 65 20 74 61 73 6b 0a 20 20 63 61 75 73  adle task.  caus
1b50: 65 73 20 74 68 65 20 61 61 72 20 66 69 6c 65 20  es the aar file 
1b60: 74 6f 20 62 65 20 63 72 65 61 74 65 64 20 61 74  to be created at
1b70: 3a 0a 20 20 3c 63 6f 64 65 3e 73 71 6c 69 74 65  :.  <code>sqlite
1b80: 33 2f 62 75 69 6c 64 2f 6f 75 74 70 75 74 73 2f  3/build/outputs/
1b90: 61 61 72 2f 73 71 6c 69 74 65 33 2d 72 65 6c 65  aar/sqlite3-rele
1ba0: 61 73 65 2e 61 61 72 3c 2f 63 6f 64 65 3e 2e 0a  ase.aar</code>..
1bb0: 20 20 3c 70 3e 0a 20 20 4f 6e 63 65 20 74 68 65    <p>.  Once the
1bc0: 20 63 75 73 74 6f 6d 20 61 61 72 20 66 69 6c 65   custom aar file
1bd0: 20 68 61 73 20 62 65 65 6e 20 63 72 65 61 74 65   has been create
1be0: 64 2c 20 69 74 20 6d 61 79 20 62 65 20 75 73 65  d, it may be use
1bf0: 64 20 69 6e 20 61 6e 20 41 6e 64 72 6f 69 64 0a  d in an Android.
1c00: 20 20 53 74 75 64 69 6f 20 61 70 70 6c 69 63 61    Studio applica
1c10: 74 69 6f 6e 20 61 73 20 64 65 73 63 72 69 62 65  tion as describe
1c20: 64 20 61 62 6f 76 65 2e 20 54 68 65 20 61 61 72  d above. The aar
1c30: 20 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20   file should be 
1c40: 72 6f 75 67 68 6c 79 0a 20 20 34 2e 35 4d 42 20  roughly.  4.5MB 
1c50: 69 6e 20 73 69 7a 65 2e 20 49 66 20 69 74 20 69  in size. If it i
1c60: 73 20 6d 75 63 68 20 73 6d 61 6c 6c 65 72 20 74  s much smaller t
1c70: 68 61 6e 20 74 68 69 73 20 28 63 6c 6f 73 65 72  han this (closer
1c80: 20 74 6f 20 31 30 30 4b 42 29 2c 20 74 68 69 73   to 100KB), this
1c90: 0a 20 20 69 6e 64 69 63 61 74 65 73 20 74 68 61  .  indicates tha
1ca0: 74 20 74 68 65 20 61 61 72 20 66 69 6c 65 20 69  t the aar file i
1cb0: 73 20 6d 69 73 73 69 6e 67 20 74 68 65 20 6e 61  s missing the na
1cc0: 74 69 76 65 20 6c 69 62 72 61 72 69 65 73 2e 20  tive libraries. 
1cd0: 54 68 65 20 75 73 75 61 6c 0a 20 20 63 61 75 73  The usual.  caus
1ce0: 65 20 6f 66 20 74 68 69 73 20 69 73 20 61 6e 20  e of this is an 
1cf0: 75 6e 6e 6f 74 69 63 65 64 20 65 72 72 6f 72 20  unnoticed error 
1d00: 77 68 69 6c 65 20 62 75 69 6c 64 69 6e 67 20 74  while building t
1d10: 68 65 20 6e 61 74 69 76 65 20 6c 69 62 72 61 72  he native librar
1d20: 69 65 73 20 0a 20 20 28 73 74 65 70 20 32 20 61  ies .  (step 2 a
1d30: 62 6f 76 65 29 2e 0a 20 20 3c 70 3e 0a 20 20 49  bove)..  <p>.  I
1d40: 66 20 74 68 65 20 3c 63 6f 64 65 3e 41 6e 64 72  f the <code>Andr
1d50: 6f 69 64 2e 6d 6b 3c 2f 63 6f 64 65 3e 20 66 69  oid.mk</code> fi
1d60: 6c 65 20 64 65 73 63 72 69 62 65 64 20 69 6e 20  le described in 
1d70: 73 74 65 70 20 32 20 61 62 6f 76 65 20 69 73 20  step 2 above is 
1d80: 65 64 69 74 65 64 20 0a 20 20 61 66 74 65 72 20  edited .  after 
1d90: 61 20 62 75 69 6c 64 20 68 61 73 20 62 65 65 6e  a build has been
1da0: 20 72 75 6e 2c 20 69 74 20 6d 61 79 20 62 65 20   run, it may be 
1db0: 6e 65 63 65 73 73 61 72 79 20 74 6f 20 72 75 6e  necessary to run
1dc0: 20 74 68 65 20 0a 20 20 67 72 61 64 6c 65 20 22   the .  gradle "
1dd0: 63 6c 65 61 6e 22 20 74 61 72 67 65 74 20 28 65  clean" target (e
1de0: 69 74 68 65 72 20 77 69 74 68 20 3c 63 6f 64 65  ither with <code
1df0: 3e 2e 2e 2f 67 72 61 64 6c 65 77 20 63 6c 65 61  >../gradlew clea
1e00: 6e 3c 2f 63 6f 64 65 3e 20 6f 72 20 74 68 72 6f  n</code> or thro
1e10: 75 67 68 0a 20 20 41 6e 64 72 6f 69 64 20 53 74  ugh.  Android St
1e20: 75 64 69 6f 29 20 62 65 66 6f 72 65 20 72 65 62  udio) before reb
1e30: 75 69 6c 64 69 6e 67 20 74 68 65 20 61 61 72 20  uilding the aar 
1e40: 66 69 6c 65 20 74 6f 20 65 6e 73 75 72 65 20 61  file to ensure a
1e50: 20 63 6f 72 72 65 63 74 20 62 75 69 6c 64 2e 0a   correct build..
1e60: 3c 2f 6f 6c 3e 0a 0a 3c 68 32 3e 20 3c 61 20 6e  </ol>..<h2> <a n
1e70: 61 6d 65 3d 64 69 72 65 63 74 69 6e 74 3e 3c 2f  ame=directint></
1e80: 61 3e 20 33 2e 20 41 64 64 69 6e 67 20 53 6f 75  a> 3. Adding Sou
1e90: 72 63 65 20 43 6f 64 65 20 44 69 72 65 63 74 6c  rce Code Directl
1ea0: 79 20 74 6f 20 74 68 65 20 41 70 70 6c 69 63 61  y to the Applica
1eb0: 74 69 6f 6e 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 54  tion</h2>..<p>.T
1ec0: 68 65 20 53 51 4c 69 74 65 20 41 6e 64 72 6f 69  he SQLite Androi
1ed0: 64 20 62 69 6e 64 69 6e 67 73 20 63 6f 64 65 20  d bindings code 
1ee0: 6d 61 79 20 61 6c 73 6f 20 62 65 20 61 64 64 65  may also be adde
1ef0: 64 20 64 69 72 65 63 74 6c 79 20 74 6f 20 74 68  d directly to th
1f00: 65 20 0a 61 70 70 6c 69 63 61 74 69 6f 6e 20 70  e .application p
1f10: 72 6f 6a 65 63 74 2c 20 73 6f 20 74 68 61 74 20  roject, so that 
1f20: 69 74 20 69 73 20 62 75 69 6c 74 20 61 6e 64 20  it is built and 
1f30: 64 65 70 6c 6f 79 65 64 20 69 6e 20 74 68 65 20  deployed in the 
1f40: 73 61 6d 65 20 77 61 79 20 0a 61 73 20 61 6c 6c  same way .as all
1f50: 20 6f 74 68 65 72 20 61 70 70 6c 69 63 61 74 69   other applicati
1f60: 6f 6e 20 63 6f 64 65 2e 0a 0a 3c 70 3e 0a 54 6f  on code...<p>.To
1f70: 20 63 6f 70 79 20 74 68 65 20 53 51 4c 69 74 65   copy the SQLite
1f80: 20 41 6e 64 72 6f 69 64 20 62 69 6e 64 69 6e 67   Android binding
1f90: 73 20 63 6f 64 65 20 69 6e 74 6f 20 61 6e 20 61  s code into an a
1fa0: 70 70 6c 69 63 61 74 69 6f 6e 3a 0a 0a 3c 6f 6c  pplication:..<ol
1fb0: 3e 0a 20 20 3c 6c 69 3e 20 4f 62 74 61 69 6e 20  >.  <li> Obtain 
1fc0: 74 68 65 20 63 6f 64 65 20 69 6e 20 74 68 65 20  the code in the 
1fd0: 73 61 6d 65 20 77 61 79 20 61 73 20 5b 23 6f 62  same way as [#ob
1fe0: 74 61 69 6e 63 6f 64 65 20 7c 20 64 65 73 63 72  taincode | descr
1ff0: 69 62 65 64 20 61 62 6f 76 65 5d 2e 0a 0a 20 20  ibed above]...  
2000: 3c 6c 69 3e 20 52 65 63 75 72 73 69 76 65 6c 79  <li> Recursively
2010: 20 63 6f 70 79 20 74 68 65 20 63 6f 6e 74 65 6e   copy the conten
2020: 74 73 20 6f 66 20 74 68 65 20 3c 63 6f 64 65 3e  ts of the <code>
2030: 73 71 6c 69 74 65 33 2f 6d 61 69 6e 2f 73 72 63  sqlite3/main/src
2040: 2f 6a 6e 69 2f 3c 2f 63 6f 64 65 3e 0a 20 20 20  /jni/</code>.   
2050: 20 20 20 20 64 69 72 65 63 74 6f 72 79 20 69 6e      directory in
2060: 74 6f 20 74 68 65 20 61 70 70 6c 69 63 61 74 69  to the applicati
2070: 6f 6e 20 6f 72 20 61 70 70 6c 69 63 61 74 69 6f  on or applicatio
2080: 6e 20 6d 6f 64 75 6c 65 73 20 3c 63 6f 64 65 3e  n modules <code>
2090: 6a 6e 69 2f 3c 2f 63 6f 64 65 3e 20 0a 20 20 20  jni/</code> .   
20a0: 20 20 20 20 64 69 72 65 63 74 6f 72 79 2e 20 54      directory. T
20b0: 68 65 6e 2c 20 66 72 6f 6d 20 74 68 65 20 70 61  hen, from the pa
20c0: 72 65 6e 74 20 6f 66 20 74 68 65 20 3c 63 6f 64  rent of the <cod
20d0: 65 3e 6a 6e 69 2f 3c 2f 63 6f 64 65 3e 20 64 69  e>jni/</code> di
20e0: 72 65 63 74 6f 72 79 2c 20 72 75 6e 0a 20 20 20  rectory, run.   
20f0: 20 20 20 20 74 68 65 20 3c 63 6f 64 65 3e 6e 64      the <code>nd
2100: 6b 2d 62 75 69 6c 64 3c 2f 63 6f 64 65 3e 20 63  k-build</code> c
2110: 6f 6d 6d 61 6e 64 2c 20 61 73 20 5b 23 62 75 69  ommand, as [#bui
2120: 6c 64 6e 61 74 69 76 65 20 7c 20 64 65 73 63 72  ldnative | descr
2130: 69 62 65 64 20 68 65 72 65 5d 2e 20 0a 0a 20 20  ibed here]. ..  
2140: 3c 6c 69 3e 20 52 65 63 75 72 73 69 76 65 6c 79  <li> Recursively
2150: 20 63 6f 70 79 20 74 68 65 20 63 6f 6e 74 65 6e   copy the conten
2160: 74 73 20 6f 66 20 74 68 65 20 3c 63 6f 64 65 3e  ts of the <code>
2170: 73 71 6c 69 74 65 33 2f 6d 61 69 6e 2f 73 72 63  sqlite3/main/src
2180: 2f 6a 61 76 61 2f 3c 2f 63 6f 64 65 3e 0a 20 20  /java/</code>.  
2190: 20 20 20 20 20 64 69 72 65 63 74 6f 72 79 20 74       directory t
21a0: 6f 20 77 68 65 72 65 65 76 65 72 20 74 68 65 20  o whereever the 
21b0: 61 70 70 6c 69 63 61 74 69 6f 6e 20 6a 61 76 61  application java
21c0: 20 63 6f 64 65 20 69 73 2e 0a 3c 2f 6f 6c 3e 0a   code is..</ol>.
21d0: 0a 0a 0a                                         ...