david
/
xowa
mirror da https://github.com/gnosygnu/xowa.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335
							<!DOCTYPE html>
<html dir="ltr">
<head>
  <meta http-equiv="content-type" content="text/html;charset=UTF-8" />
  <title>App/Setup/Upgrading - XOWA</title>
  <link rel="shortcut icon" href="https://gnosygnu.github.io/xowa/xowa_logo.png" />
  <link rel="stylesheet" href="https://gnosygnu.github.io/xowa/xowa_common.css" type="text/css">
  
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject skin-vector action-submit vector-animateLayout" spellcheck="false">
<div id="mw-page-base" class="noprint"></div>
<div id="mw-head-base" class="noprint"></div>
<div id="content" class="mw-body">
  <h1 id="firstHeading" class="firstHeading"><span>App/Setup/Upgrading</span></h1>
  <div id="bodyContent" class="mw-body-content">
    <div id="siteSub">From XOWA: the free, open-source, offline wiki application</div>
    <div id="contentSub"></div>
    <div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
    
    <p>
      This page describes how to update your XOWA application manually.
    </p>
    <div id="toc" class="toc">
      <div id="toctitle" class="toctitle">
        <h2>
          Contents
        </h2>
      </div>
      <ul>
        <li class="toclevel-1 tocsection-1">
          <a href="#Background"><span class="tocnumber">1</span> <span class="toctext">Background</span></a>
        </li>
        <li class="toclevel-1 tocsection-2">
          <a href="#Upgrade_by_an_xowa_upgrade_package"><span class="tocnumber">2</span> <span class="toctext">Upgrade by an xowa_upgrade package</span></a> 
          <ul>
            <li class="toclevel-2 tocsection-3">
              <a href="#Upgrade_process"><span class="tocnumber">2.1</span> <span class="toctext">Upgrade process</span></a>
            </li>
            <li class="toclevel-2 tocsection-4">
              <a href="#Upgrade_shelf-life_of_4_weeks"><span class="tocnumber">2.2</span> <span class="toctext">Upgrade shelf-life of 4 weeks</span></a>
            </li>
            <li class="toclevel-2 tocsection-5">
              <a href="#Upgrade_issues_should_fallback_to_xowa_app_packages"><span class="tocnumber">2.3</span> <span class="toctext">Upgrade issues should fallback to xowa_app packages</span></a>
            </li>
          </ul>
        </li>
        <li class="toclevel-1 tocsection-6">
          <a href="#Upgrade_by_an_xowa_app_package"><span class="tocnumber">3</span> <span class="toctext">Upgrade by an xowa_app package</span></a>
        </li>
        <li class="toclevel-1 tocsection-7">
          <a href="#Upgrade_by_an_xowa_app_package_and_regenerating_the_XOWA_root_directory"><span class="tocnumber">4</span> <span class="toctext">Upgrade by an xowa_app package and regenerating the XOWA root directory</span></a>
        </li>
        <li class="toclevel-1 tocsection-8">
          <a href="#In-app_updater"><span class="tocnumber">5</span> <span class="toctext">In-app updater</span></a>
        </li>
      </ul>
    </div>
    <h2>
      <span class="mw-headline" id="Background">Background</span>
    </h2>
    <p>
      XOWA has a rapid release cycle, with a new version coming out every week. For more details, see <a href="/wiki/Help/Release_schedule" id="xolnki_2" title="Help/Release schedule">Help/Release_schedule</a>.
    </p>
    <p>
      XOWA releases frequently for a few reasons:
    </p>
    <ul>
      <li>
        <b>MediaWiki updates frequently</b>: English Wikipedia and all the other Wikimedia wikis use a <a href="https://www.mediawiki.org/wiki/Version_lifecycle" rel="nofollow" class="external text">continuous integration model</a>. These releases tend to come out very quickly with releases as often as every week. See <a href="https://www.mediawiki.org/wiki/News" rel="nofollow" class="external free">https://www.mediawiki.org/wiki/News</a> for an example of the release schedule
      </li>
      <li>
        <b>XOWA is still young</b>: XOWA was only released in 2012-12-31. Although a lot of features have been added since then, there are still a lot of features to be added.
      </li>
      <li>
        <b>Frequent release philosophy</b>: I personally prefer having frequent releases as opposed to larger infrequent releases. The former is more manageable, and keeps overall development nimble.
      </li>
    </ul>
    <h2>
      <span class="mw-headline" id="Upgrade_by_an_xowa_upgrade_package">Upgrade by an xowa_upgrade package</span>
    </h2>
    <p>
      <code>xowa_upgrade</code> packages are produced with every release.
    </p>
    <h3>
      <span class="mw-headline" id="Upgrade_process">Upgrade process</span>
    </h3>
    <p>
      To upgrade, do the following:
    </p>
    <p>
      <b>Windows</b>
    </p>
    <ul>
      <li>
        Download the "xowa_upgrade" exe for your operating system. For example, if you're on Windows with a 64-bit JVM and upgrading to v2.8.2, you would download xowa_upgrade_windows_64_v2.8.2.1.exe
      </li>
      <li>
        Place the .exe in your xowa root directory. For example, if you're running XOWA by using <code>C:\xowa\xowa_64.exe</code>, then place xowa_upgrade_windows_64_v2.8.2.1.exe in <code>C:\xowa</code> so that the file name is <code>C:\xowa\xowa_upgrade_windows_64_v2.8.2.1.exe</code>
      </li>
      <li>
        Double-click the "xowa_upgrade.exe". The upgrade is a self-extracting 7-zip exe and will unzip all files and place them in the correct locations. Among other things, you'll have a new xowa.jar file. For example, <code>C:\xowa\xowa_windows_64.jar</code> should show a recent date.
      </li>
    </ul>
    <p>
      <b>Linux / Mac OS X</b>
    </p>
    <ul>
      <li>
        Download the "xowa_upgrade" zip for your operating system
      </li>
      <li>
        Place the .zip in your xowa root directory. For example, if you're running Mac OS X by using <code>/Users/your_user_name/xowa/xowa_macosx_64.sh</code>, then place xowa_upgrade_macosx_64_v2.8.2.1.zip in <code>/Users/your_user_name/xowa/</code> so that the file name is <code>/Users/your_user_name/xowa/xowa_upgrade_macosx_64_v2.8.2.1.zip</code>
      </li>
      <li>
        Extract the files. Note that depending on your unzip program, the file may be placed in a new sub-directory. For example, on Mac OS X, the files will be unzipped to a new folder called <code>/Users/your_user_name/xowa/xowa_upgrade_macosx_64_v2.8.2.1/</code>
      </li>
      <li>
        Move the files from the extracted folder to the XOWA root folder. Overwrite any files in the process. For example, on Mac OS X, there will be a new file called <code>/Users/your_user_name/xowa/xowa_upgrade_macosx_64_v2.8.2.1/xowa_macosx_64.jar</code>. This should be moved to <code>/Users/your_user_name/xowa/xowa_macosx_64.jar</code> and overwrite the existing version.
      </li>
    </ul>
    <h3>
      <span class="mw-headline" id="Upgrade_shelf-life_of_4_weeks">Upgrade shelf-life of 4 weeks</span>
    </h3>
    <p>
      A given upgrade will only work if your release is within the past 4 weeks. For example:
    </p>
    <ul>
      <li>
        You start off with the v2.1.3 application.
      </li>
      <li>
        v2.1.4 is released. You can use the v2.1.4 upgrade since your v2.1.3 release is 1 week old
      </li>
      <li>
        v2.2.1 is released and you haven't upgraded anything. You can use the v2.2.1 upgrade since your v2.1.3 release is 2 weeks old.
      </li>
      <li>
        v2.2.2 is released and you haven't upgraded anything. You can use the v2.2.2 upgrade since your v2.1.3 release is 3 weeks old.
      </li>
      <li>
        v2.2.3 is released and you haven't upgraded anything. You can use the v2.2.3 upgrade since your v2.1.3 release is 4 weeks old.
      </li>
      <li>
        v2.2.4 is released and you haven't upgraded anything. You can not use the v2.2.4 upgrade since your v2.1.3 release is 5 weeks old. You must get a new application package
      </li>
    </ul>
    <p>
      Once you upgrade, the 4-week window resets. You can perpetually upgrade XOWA in this fashion. For example:
    </p>
    <ul>
      <li>
        You start off with the v2.1.3 application.
      </li>
      <li>
        You upgrade when v2.2.3 is released. Your release will now be v2.2.3
      </li>
      <li>
        You upgrade again when v2.3.3 is released. Your release will now be v2.3.3
      </li>
      <li>
        You upgrade again when v2.4.1 is released. Your release will now be v2.4.1
      </li>
      <li>
        And so on...
      </li>
    </ul>
    <h3>
      <span class="mw-headline" id="Upgrade_issues_should_fallback_to_xowa_app_packages">Upgrade issues should fallback to xowa_app packages</span>
    </h3>
    <p>
      If you have problems after using an xowa_upgrade package, try upgrading using an xowa_app package. I personally test xowa_app packages on both Windows and Linux for every release and these will always work. In addition, due to the nature of the build script, the application package is always guaranteed to have the latest changes.
    </p>
    <h2>
      <span class="mw-headline" id="Upgrade_by_an_xowa_app_package">Upgrade by an xowa_app package</span>
    </h2>
    <p>
      You can also upgrade by downloading an xowa_app package and unzipping everything in the xowa root directory. For example:
    </p>
    <ul>
      <li>
        Download the "xowa_app" zip for your operating system
      </li>
      <li>
        Place the .zip in your xowa root directory. For example, if you're running on Windows 64-bit by using <code>C:\xowa\windows_64.exe</code>, then place xowa_app_windows_64_v2.8.2.1.zip in <code>C:\xowa\windows_64\</code> so that the file name is <code>C:\xowa\windows_64\xowa_app_windows_64_v2.8.2.1.zip</code>
      </li>
      <li>
        Extract the files. Note that depending on your unzip program, the file may be placed in a new sub-directory. For example, on Windows 64-bit, the files will be unzipped to a new folder called <code>C:\xowa\windows_64\xowa_app_windows_64_v2.8.2.1\</code>
      </li>
      <li>
        Move the files from the extracted folder to the XOWA root folder. Overwrite any files in the process. For example, on Windows 64-bit, there will be a new file called <code>C:\xowa\windows_64\xowa_app_windows_64_v2.8.2.1\xowa_windows_64.jar</code>. This should be moved to <code>C:\xowa\windows_64\xowa_windows_64.jar</code> and overwrite the existing version.
      </li>
    </ul>
    <p>
      Note that you can always just upgrade using the <code>xowa_app</code> package. The <code>xowa_upgrade</code> packages are provided because they are generally 5 to 10 times smaller than the application packages.
    </p>
    <h2>
      <span class="mw-headline" id="Upgrade_by_an_xowa_app_package_and_regenerating_the_XOWA_root_directory">Upgrade by an xowa_app package and regenerating the XOWA root directory</span>
    </h2>
    <p>
      You can also do an upgrade by renaming your existing XOWA root directory and unzipping a new app package in the same directory. For example, assuming a Windows system with XOWA in <code>C:\xowa</code>
    </p>
    <ul>
      <li>
        Rename the <code>C:\xowa</code> folder to <code>C:\xowa-old</code>
      </li>
      <li>
        Download an app package and unzip it to <code>C:\xowa</code>
      </li>
      <li>
        Move the following directories from <code>C:\xowa-old</code> to <code>C:\xowa</code> 
        <ul>
          <li>
            <code>C:\xowa-old\wiki</code> to <code>C:\xowa\wiki</code>
          </li>
          <li>
            <code>C:\xowa-old\file</code> to <code>C:\xowa\file</code>
          </li>
          <li>
            <code>C:\xowa-old\user</code> to <code>C:\xowa\user</code>
          </li>
        </ul>
      </li>
    </ul>
    <p>
      This approach is more manual, but is meant as an alternate approach. It's also useful for moving XOWA from one drive to another.
    </p>
    <h2>
      <span class="mw-headline" id="In-app_updater">In-app updater</span>
    </h2>
    <p>
      XOWA also has an in-app updater. See <a href="/wiki/App/Setup/Update/In-app" id="xolnki_3" title="App/Setup/Update/In-app">the in-app help page</a>
    </p>
  
    </div>
  </div>
</div>


<div id="mw-head" class="noprint">
  <div id="left-navigation">
    <div id="p-namespaces" class="vectorTabs">
      <h3>Namespaces</h3>
      <ul>
        <li  id="ca-nstab-main" class="selected"><span><a id="ca-nstab-main-href" href="index.html">Page</a></span></li>
      </ul>
    </div>
  </div>
</div>

<div id='mw-panel' class='noprint'>
  <div id='p-logo'>
    <a style="background-image: url(https://gnosygnu.github.io/xowa/xowa_logo.png);" href="http://xowa.org/" title="Visit the main page"></a>
  </div>
  <div class="portal" id='xowa-portal-home'>
    <h3>XOWA</h3>
    <div class="body">
      <ul>
        <li><a href="http://xowa.org/index.html" title='Visit the main page'>Main page</a></li>
        <li><a href="http://xowa.org/screenshots.html" title='See screenshots of XOWA'>Screenshots</a></li>
        <li><a href="https://www.youtube.com/watch?v=q0qbXYXEH6M" title="See a video of XOWA Desktop in action">Video</a></li>
        <li><a href="http://xowa.org/home/wiki/Help/Download_XOWA.html" title='Download the XOWA application'>Download XOWA</a></li>
        <li><a href="http://xowa.org/home/wiki/Dashboard/Image_databases.html" title='Download offline wikis and image databases'>Download wikis</a></li>
      </ul>
    </div>
  </div>

  <div class="portal" id='xowa-portal-started'>
    <h3>Getting started</h3>
    <div class="body">
      <ul>
        <li><a href="http://xowa.org/home/wiki/App/Setup/System_requirements.html" title='Get XOWA&apos;s system requirements'>Requirements</a></li>
        <li><a href="http://xowa.org/home/wiki/App/Setup/Installation.html" title='Get instructions for installing XOWA'>Installation</a></li>
        <li><a href="http://xowa.org/home/wiki/App/Import/Simple_Wikipedia.html" title='Learn how to set up Simple Wikipedia'>Simple Wikipedia</a></li>
        <li><a href="http://xowa.org/home/wiki/App/Import/English_Wikipedia.html" title='Learn how to set up English Wikipedia'>English Wikipedia</a></li>
        <li><a href="http://xowa.org/home/wiki/App/Import/Other_wikis.html" title='Learn how to set up other Wikipedias'>Other Wikipedias</a></li>
      </ul>
    </div>
  </div>

  <div class="portal" id='xowa-portal-android'>
    <h3>Android</h3>
    <div class="body">
      <ul>
        <li><a href="http://xowa.org/home/wiki/Android/Setup.html" title='Setup XOWA on your Android device'>Setup</a></li>
        <li><a href="https://www.youtube.com/watch?v=jsMTBxGweUw" title="See a video of XOWA Android in action">Video</a></li>
      </ul>
    </div>
  </div>

  <div class="portal" id='xowa-portal-help'>
    <h3>Help</h3>
    <div class="body">
      <ul>
        <li><a href="http://xowa.org/home/wiki/Help/About.html" title='Get more information about XOWA'>About</a></li>
        <li><a href="http://xowa.org/home/wiki/Help/Contents.html" title='View a list of help topics'>Contents</a></li>
        <li><a href="http://xowa.org/home/wiki/Help/Media.html" title='Read what others have written about XOWA'>Media</a></li>
        <li><a href="http://xowa.org/home/wiki/Help/Feedback.html" title='Questions? Comments? Leave feedback for XOWA'>Feedback</a></li>
      </ul>
    </div>
  </div>
  
  <div class="portal" id='xowa-portal-blog'>
    <h3>Blog</h3>
    <div class="body">
      <ul>
        <li><a href="http://xowa.org/home/wiki/Blog.html" title='Follow XOWA''s development process'>Current</a></li>
      </ul>
    </div>
  </div>

  <div class="portal" id='xowa-portal-links'>
    <h3>Links</h3>
    <div class="body">
      <ul>
        <li><a href="http://dumps.wikimedia.org/backup-index.html" title="Get wiki datababase dumps directly from Wikimedia">Wikimedia dumps</a></li>
        <li><a href="https://archive.org/search.php?query=xowa" title="Search archive.org for XOWA files">XOWA @ archive.org</a></li>
        <li><a href="http://en.wikipedia.org" title="Visit Wikipedia (and compare to XOWA!)">English Wikipedia</a></li>
      </ul>
    </div>
  </div>

  <div class="portal" id='xowa-portal-donate'>
    <h3>Donate</h3>
    <div class="body">
      <ul>
        <li><a href="https://archive.org/donate/index.php" title="Support archive.org!">archive.org</a></li><!-- listed first due to recent fire damages: http://blog.archive.org/2013/11/06/scanning-center-fire-please-help-rebuild/ -->
        <li><a href="https://donate.wikimedia.org/wiki/Special:FundraiserRedirector" title="Support Wikipedia!">Wikipedia</a></li>
        <li><a href="http://xowa.org/home/wiki/Help/Donate.html" title="Support XOWA!">XOWA</a></li>
      </ul>
    </div>
  </div>
  
</div>
</body>
</html>