2015年8月
            1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31          

最近のトラックバック

最近買った本(Amazon.co.jp)

広告(Amazon.co.jp)

広告(Google AdSense)

無料ブログはココログ

カテゴリー「Windows」の8件の記事

2011年10月 6日 (木)

TeX入門: TeXの出力環境を作成する。(その1、Windows版)

はじめに

数年ぶりにTeXを使う機会があったので、WindowsにTeXをインストールする方法をまとめてみた。尚、Linuxについては別の記事にまとめる予定なのでそちらを参照して欲しい。

また、この記事を作成するにあたり「[改訂第5版] LaTex2e 美文書作成入門」(amazon.co.jp)という本を参考にした。この本に付属のDVD-ROMに収録されているWindows用のインストーラーは、この記事で紹介している阿部紀行さんのTeXインストーラ3を一部カスタマイズしたものである。インターネットで公開されているものとの違いは、インストールされる関連ツールの一部が差し替えられていること、ファイルの取得先がインターネットでは無くDVD-ROMであること、追加の日本語フォントと設定ファイルなどが含まれていることである。

使用環境

  • Windows 7 Professional SP1

  • Windows XP Professional SP3

WindowsへのTexのインストール

ここでは、TeXインストーラ3を使用して、WindowsにTexをインストールする方法を説明する。TeXインストーラ3を使用すれば、以下のW32TeX(Windows用のTeX)、及び、関連ツールを自動的にダウンロード、及び、インストールすることができる。

  • 角藤さんによるW32TeX

  • dviout for Windows

  • Ghostscript

  • GSview

ダウンロード

TeXインストーラ3のページからTeXインストーラ3をダウンロードする。

  • Webブラウザからページの下の方にあるダウンロードの「最新版(0.81r7)」をクリックしてインストーラーのアーカイブを適当なフォルダに保存する。

    図1 TeXインストーラ3のページ

    Tex_installer_3_download_02a

    尚、この記事を作成した時点の最新版のファイル名は以下の通りである。

    abtexinst_0_81r7.zip

インストール

TeXインストーラ3はインストールに必要なファイルをインターネットから自動的にダウンロードするため、実行時はインターネットに接続している必要がある。また、古いTeXやGhostscript、GSView、divoutなどがインストールされている場合はあらかじめアンインストールしておいた方が良い。尚、詳細はアーカイブに付属のabtexinst.txtファイルを参照すること。

  1. アーカイブを7-Zipなどのファイルアーカイバを使用して適当なフォルダに展開する。エクスプローラーを使用する場合は、アーカイブを開くとabtexinstというフォルダがあるので右クリックメニューからコピーし、適当なフォルダに貼り付ける。

    図2 アーカイブの中身

    Tex_installer_3_archive_02a

  2. 展開したabtexinstフォルダの下のabtexinst.exeを実行してインストーラーを起動する。

    図3 abtexinstフォルダ

    Tex_installer_3_archive_03a

  3. インストーラが起動したら指示に従って[次へ]ボタンを続けて押下する。

    図4 Texのインストール1

    Tex_installer_3_01

    図5 Texのインストール2

    Tex_installer_3_02

    図6 Texのインストール3

    Tex_installer_3_03

    図7 Texのインストール4

    Tex_installer_3_04

  4. インストールが進むとGostscriptのインストーラーが別に起動されるので、設定はデフォルトのまま[Install]ボタンを押下する。

    図8 Ghostscriptのインストール

    Tex_installer_3_06

  5. 同様にGSViewのインストーラーが別に起動されるので、[Setup]ボタンを押下する。また、次のSelect Lunguageダイアログでは[English]ボタンを押下する。

    図9 GSViewのインストール

    Tex_installer_3_09

    図10 Select Language

    Tex_installer_3_10

  6. 次の画面以降では、設定はデフォルトのまま[Next]ボタンを続けて押下する。尚、最後は[Finish]→[Exit]ボタン押下で終了となる。

    図11 GSViewのインストール1

    Tex_installer_3_11

    画像GSViewのインストール2~7は省略。

    図12 GSViewのインストール8

    Tex_installer_3_18

  7. 同様にdvioutのインストーラーが別に起動されるので、設定はデフォルトのまま[OK]ボタンを押下する。

    図13 dvioutのインストール

    Tex_installer_3_19

  8. 最後にインストールの完了ダイアログが表示されるので、インストール結果を確認し[完了]ボタンを押下する。

    図14 インストールの完了

    Tex_installer_3_20

TexWorksによるTex文書の作成

TeXWorksはTeX文書を作成するための統合環境である。TeXエディタとPDFビューワーを含むため、TeXの文書を作成してすぐに結果を確認することができる。W32TeXをインストールするとメニューやダイアログが日本語化されたTeXWorksが一緒にインストールされる。ただし、インストール直後の状態では、TeXWorksで日本語を含むPDFを表示すると日本語部分が全て空白になってしまう。これは、TeXWorksがPDFに埋め込まれていないフォントを表示することができないためで、この問題を回避するには、PDFを生成するさいに日本語フォントが埋め込まれるように設定ファイルを記述する必要がある。

日本語フォントの設定

W32TeXのインストール先のtexmfフォルダの下に設定ファイルのオリジナルがあるので、それをtexmf-localフォルダにコピーしてから修正する。アップデートのさいにオリジナルは上書きされる可能性があるのでこのようにする。

  1. エクスプローラーなどで、texmfフォルダの下の設定ファイル(cid-x.map)をtexmf-localフォルダの下にコピーする。このとき、コピー先に同じ階層のフォルダを作成する必要がある。

    コピー元

    C:\w32tex\share\texmf\
      fonts\map\dvipdfmx\base
        cid-x.map

    コピー先

    C:\w32tex\share\texmf-local\
      fonts\map\dvipdfmx\base
        cid-x.map
  2. コピー先の設定ファイル(cid-x.map)をメモ帳などで以下のように修正する。この例ではWindowsのMS明朝とMSゴシックを指定している。

    修正前

    %
    % Ryumin and GothicBBB found in PostScript printers:
    %
    rml   H Ryumin-Light
    gbm   H GothicBBB-Medium
    rmlv  V Ryumin-Light
    gbmv  V GothicBBB-Medium

    修正後

    %
    % Ryumin and GothicBBB found in PostScript printers:
    %
    rml   H :0:msmincho.ttc
    gbm   H :0:msgothic.ttc
    rmlv  V :0:msmincho.ttc
    gbmv  V :0:msgothic.ttc

TexWorksの起動

エクスプローラーなどから、以下の実行ファイルを起動する。尚、必要に応じてデスクトップなどにショートカットを作成しておくと良いだろう。

C:\w32tex\share\
  texworks\
    TeXworks.exe

図15 TeXWorks起動画面

Texworks_01

TexWorksの動作確認

TeXWorksの入力領域に以下のサンプルを入力する。

\documentclass{jsarticle}
\usepackage{okumacro}
\begin{document}

ああ、生きてゐる。何だか\ruby{酷}{ひど}く男が\ruby{羨}{うらや}ましくなつてしまつた。 

\end{document}

図16 入力画面

Texworks_sample_01a

ツールバーのタイプセットのドロップダウンリストで「pdfpLaTeX」が選択されていることを確認し、タイプセットボタン(緑に矢印)を押下する。その結果、以下のようなプレビューが表示され日本語が表示されていれば設定は正しく行われている。

図17 プレビュー画面

Texworks_sample_02

以上

2011/10/06、新規作成。
2011/10/07、誤字と一部の表現を訂正した。図の位置とサイズを修正した。
2011/10/10、リンクの抜けを修正した。

2011年9月25日 (日)

Excel/VBA入門: 英数字を半角に変換し、半角カナを全角に変換する。

以前、某所に掲載したものの改良版です。

ワークシートに入力された文字列について、英数字や片仮名のように半角(1Byte)と全角(2Byte)の文字が存在するものをどちらか一方に統一したいということが良くある。この場合、VBAのStrConv関数を使用して全てのセルの文字列を一括変換すれば良い。

str = StrConv(str, vbNarrow) ' 文字列を半角(1Byte)に変換する。
str = StrConv(str, vbWide)   ' 文字列を全角(2Byte)に変換する。

しかし、英数字は半角に統一したいが、「いわゆる半角カナ」などと呼ばれ過去に多くの問題を引き起こしてきた半角カナ(0xA1-0xCF)だけは全角に変換したいという場合、StrConvなどの既存の関数では一度に変換できないため、少し工夫が必要となる。

というわけで、英数字を半角に変換し、半角カナを全角に変換するプロ-シージャーを作成してみた。

Sub ToHankakuWithoutKatakana()
    '
    ' 現在のワークシートの値が入力されている全てのセルについて、
    ' 半角変換可能な全角文字を全て半角に変換する。
    ' ただし、半角カナ(0xA1-0xCF)については全角に変換する。
    ' また、可能であればカナ文字と直後の濁点・半濁点が合成される。
    '
    ' 2011/09/25 hichon: 新規作成。
    '
    Dim re As Object
    Dim Cell As Range
    Dim Str As String
    Dim Match As Object

    '
    ' 正規表現オブジェクトを作成する。
    ' 1文字以上の半角カナ(0xA1-0xCF)を検索対象とする。
    '
    Set re = CreateObject("VBScript.RegExp")
    re.Pattern = "[。-゚]+"
    re.Global = True

    '
    ' 値が入力されている全てのセルについて、変換処理を実行する。
    ' 尚、値が入力されているセルが存在しない場合、エラーとなる。
    '
    On Error GoTo Error
    For Each Cell In Cells.SpecialCells(xlCellTypeConstants, xlTextValues)

        Str = Cell.Value
        If Str <> "" Then

            '
            ' 半角変換可能な文字を半角に変換する。
            ' 全角カナもいったん半角カナに変換される。
            '
            Str = StrConv(Str, vbNarrow)

            '
            ' 半角カナを全角に変換する。
            ' 半角カナの直後に濁点・半濁点があればここで合成される。
            '
            For Each Match In re.Execute(Str)
                Str = Replace(Str, Match, StrConv(Match, vbWide), , 1)
            Next
            Cell.Value = Str

        End If
 
    Next

    Exit Sub

Error:
    MsgBox Err.Description

End Sub

2011年9月19日 (月)

Eclipse入門: 日本語APIドキュメントをローカル環境、及び、ホバー表示で使用する。

はじめに

以前「Android入門: Androidの開発環境を作成する。(Linux/Windows対応版)」という記事で、日本語化プラグインPleiadesを使用してEclipseを日本語化する方法を説明した。PleiadesではEclipseのメニューやダイアログ、及び、エディタ上でJavaの標準APIのクラスやメソッドにカーソルを合わせてShift+F2を押下したときに表示されるドキュメントが日本語化される。

しかし、このドキュメントについてはインターネット上にあるJDKの日本語APIドキュメントを参照しているため、インターネットに接続していない環境では表示できない。また、エディタ上でJavaの標準APIのクラスやメソッドにマウスカーソルを合わせるとそれらの説明がホバー表示されるが、取得元のJDKのソースコードのコメントが英語で記述されているため、表示される説明も英語のままとなる。

そこで今回は、日本語APIドキュメントをローカルから参照する方法、及び、ホバー表示を日本語化する方法について説明する。

使用環境

  • Windows 7 Professional SP1

  • Ubuntu 11.04 Desktop 日本語Remix

  • JDK 6 update 27

  • Eclipse 3.7 Indigo + Pleiades 1.3.3

日本語APIドキュメントのインストール

日本語APIドキュメントをローカル環境にインストールする方法を説明する。インターネット上の日本語APIドキュメントについては、OracleのJavaのドキュメントページから[API]をクリックするとバージョンと言語ごとにドキュメントをまとめたページに遷移するので、例えば、[JDK Programmer Guides/6]の[Japanese]をクリックすれば、JDK 6の日本語APIドキュメントが参照できる。EclipseにPleiadesをインストールするとJavadocの参照先が英語版からこちらの日本語版に変更される。尚、現時点ではJDK 7の日本語APIドキュメントは準備されていない。

ダウンロード

日本語APIドキュメントをローカル環境で使用するには、これらのファイルをまとめてダウンロードする必要がある。しかし、Javaのダウンロードページから[Java SE 6 Documentation]の[Download]をクリックしドキュメントのダウンロードページに遷移しても英語版のアーカイブしか見当たらない。

というわけで、OracleとSunのサイトをあちこち探してみたが、以前は用意されていた日本語APIドキュメントのアーカイブが何処にも見当たらない。それらしいリンクをクリックしても英語版のページに飛ばされるだけである。どうやらサイトがリニューアルされたさいに行方不明になってしまったようだ。

いろいろ検索した結果、2chのプログラム板のJavaスレッドの書き込みから何とか無事にアーカイブを入手することができた。44さんありがとう!!因みにファイル名は以下の通りである。また、以降ファイルをダウンロードしたディレクトリを<download_dir>とする。

jdk-6u21-docs-ja.zip

また、複数バージョンのJDKをインストールして使い分けている場合、そのバージョンにあった日本語APIドキュメントのアーカイブが必要となる。updateのバージョンが異なる程度では殆ど問題ないが、メジャーバージョンが異なるとAPIの構成も異なるため問題が発生する。

2011/10/02追記:上記スレッドは過去ログ倉庫に落ちてしまったので、以下に該当部分を転載する。

http://hibari.2ch.net/test/read.cgi/tech/1312958339/41-44
42 名前:デフォルトの名無しさん[] 投稿日:2011/08/14(日) 11:26:57.48
Java6 の Javadoc 日本語ってダウンロードできなくなったの?
ja のリンクや言語の選択すらできん

43 名前:デフォルトの名無しさん[sage] 投稿日:2011/08/14(日) 11:38:29.02
所詮はオラクルがやることだからな

44 名前:デフォルトの名無しさん[sage] 投稿日:2011/08/14(日) 13:58:54.51
Oracleは正直よくわからん。
http://bit.ly/p8j9OL
jdk-6u21-docs-ja.zip

インストール

特にインストーラーなどは用意されていないので、ダウンロードしたアーカイブを対応するVersionの<java_home>にコピー、及び、展開する。尚、以降JDKがインストールされたディレクトリを<java_home>とする。

Linuxの場合

  1. アーカイブを<java_home>にコピーする。

    $ sudo cp <download_dir>/jdk-6u21-docs-ja.zip /opt/jdk1.6.0_27/
  2. unzipを使用してアーカイブを<java_home>の下に展開する。

    $ cd /opt/jdk1.6.0_27/
    $ sudo unzip jdk-6u21-docs-ja.zip

Windowsの場合

  1. 管理所特権でコマンドプロンプトを起動する。

    ツールバーの[スタート] ボタンをクリックする。→[検索] ボックスに「コマンド」と入力する。→結果一覧で [コマンド プロンプト] を右クリックし、[管理者として実行] を選択する。

  2. アーカイブを<java_home>にコピーする。

    > copy <download_dir>/jdk-6u21-docs-ja.zip "C:\Program Files\Java\jdk1.6.0_27\"
  3. 7-zipなどのファイルアーカイバを使用してアーカイブを<java_home>の下に展開する。

    > c:
    > cd "\Program Files\Java\jdk1.6.0_27"
    > "C:\Program Files\7-Zip\7z.exe" x jdk-6u21-docs-ja.zip

MergeDocのインストール

MergeDocはJDKのソースコードと日本語APIドキュメントをマージするツールである。MergeDocを使用してソースコードのコメントを日本語化すれば、標準APIのホバー表示だけでなくソースコードを参照したときのコメントも日本語化されることになる。

尚、MorgeDocのダウンロードページには「Eclipse 3.2 以降ではホバー表示は API ドキュメント HTML ソースから取得できるようになったため、ホバー表示のみを使用する場合は、MergeDoc は不要です。」とあるが、現状のEclipseではホバー表示の内容はソースコード→APIドキュメントの順番に検索されるため、ソースコードの参照とホーバー表示の日本語化を両立させるにはやはりMergedocが必要となる。

ダウンロード

MergeDocは日本語化プラグインのPleiadesと同じMergeDoc Projectのサイトで配布されている。MergeDoc Projectのトップページから左側のメニューの[MergeDoc / Javadoc 日本語化]をクリックするとMorgeDocのダウンロードページに遷移するので、「ダウンロード」から「MergeDoc本体」の最新版である[Version 2.1.4]をダウンロードする。尚、アーカイブのファイル名は以下の通り。また、以降ファイルをダウンロードしたディレクトリを<download_dir>とする。

mergedoc.zip

インストール

特にインストーラーなどは用意されていないので、ダウンロードしたアーカイブを適当なディレクトリに展開する。

Linuxの場合

ホームディレクトリの下にディレクトリmergedocを作成し、unzipを使用してアーカイブをその中に展開する。

$ cd
$ mkdir mergedoc
$ cd mergedoc
$ unzip <download_dir>/mergedoc.zip

Windowsの場合

C:\optの下にディレクトリmergedocを作成し、7-zipなどのファイルアーカイバを使用してアーカイブをその中に展開する。

> c:
> cd \opt
> mkdir mergedoc
> cd mergedoc
> "C:\Program Files\7-Zip\7z.exe" x <download_dir>\mergedoc.zip

Mergedocの使用方法

Mergedocを使用してJDKのソースコードと日本語APIドキュメントをマージする方法を説明する。

起動方法

MergedocはJavaアプリケーションのため、javaコマンドを使用して起動する。尚、-serverオプションを付けると処理が高速になるらしい。

Linuxの場合

$ cd ~/mergedoc
$ java -server -jar mergedoc.jar

Windowsの場合

> c:
> cd \opt\mergedoc
> java -server -jar mergedoc.jar

操作方法

Mergedocの操作方法について説明する。

  1. Mergedocが起動したら「基本設定」の以下の項目に値を設定する。

    • APIドキュメントディレクトリ

      日本語APIドキュメントを格納しているディレクトリを設定する。具体的にはpackage-listファイルがあるディレクトリとなる。また、エンコーディングの設定は「EUC-JP」とする。

    • 入力ソースアーカイブファイル

      Javaのソースコードのアーカイブを設定する。また、元のソースコードにはASCII以外の文字は含まれていないのでエンコーディングの設定は意味がないが、とりあえず「UTF-8」とする。

    • 出力ソースアーカイブファイル

      マージしたソースコードを出力する新規のアーカイブファイルを設定する。また、エンコーディングの設定は「UTF-8」とする。

    Linuxの場合

    以降<user_home>はユーザーのホームディレクトリとする。

    APIドキュメントディレクトリ /opt/jdk1.6.0_27/docs/ja/api EUC-JP
    入力ソースアーカイブファイル /opt/jdk1.6.0_27/src.zip UTF-8
    出力ソースアーカイブファイル <user_home>/src_ja_utf8.zip UTF-8

    Windowsの場合

    APIドキュメントディレクトリ C:\Program Files\Java\jdk1.6.0_27\docs\ja\api EUC-JP
    入力ソースアーカイブファイル C:\Program Files\Java\jdk1.6.0_27\src.zip UTF-8
    出力ソースアーカイブファイル C:\opt\src_ja_utf8.zip UTF-8

    また、「詳細設定」はデフォルトのままどの項目もチェックなしとする。

  2. [実行]ボタンを押下して、マージ処理を開始する。途中コンソールに以下のような警告がいくつか表示されるが、無視しても特に問題ないようだ。

    WARN  Comment - <コード名> 行数調整不可のためマージ出来ませんでした。
    WARN  JavaBuffer - Javadoc コメントの後のシグネチャを取得できませんでした。
  3. マージが終了したら、[終了]ボタンを押下してアプリケーションを終了する。

マージしたソースコードのインストール

マージしたソースコードのアーカイブを<java_home>に移動する。

Linuxの場合

  • アーカイブを<java_home>に移動する。

    $ sudo mv <user_home>/src_ja_utf8.zip /opt/jdk1.6.0_27/

Windowsの場合

  1. 管理所特権でコマンドプロンプトを起動する。

    ツールバーの[スタート] ボタンをクリックする。→[検索] ボックスに「コマンド」と入力する。→結果一覧で [コマンド プロンプト] を右クリックし、[管理者として実行] を選択する。

  2. アーカイブを<java_home>に移動する。

    > move C:\opt\src_ja_utf8.zip "C:\Program Files\Java\jdk1.6.0_27\"

Eclipseの設定

インストールした日本語APIドキュメント、及び、マージしたソースコードのアーカイブをEclipseから使用する方法について説明する。

ドキュメントの参照先の変更

Eclipseの設定で、以下のJREシステム・ライブラリーの「Javadoc ロケーション」、及び、「ソース添付」項目をローカル環境の日本語APIドキュメント、及び、マージしたソースコードのアーカイブに変更する。

  • <java_home>/jre/lib/resources.jar

  • <java_home>/jre/lib/rt.jar

  • <java_home>/jre/lib/jsse.jar

  • <java_home>/jre/lib/jce.jar

  • <java_home>/jre/lib/charsets.jar

また、複数バージョンのJDKをインストールして使い分けている場合、JDK毎に同様の設定が必要となる。

  1. Eclipseのウィンドウメニューから[設定]を選択する。

  2. 設定ダイアログで、左側の一覧の[Java]を展開し、[インストール済の JRE]を選択する。

  3. 「インストール済のJRE」の一覧から「jdk1.6.0_27」を選択し、[編集]ボタンを押下する。

  4. JREの編集ダイアログで、「JREの編集JREシステム・ライブラリー」から「<java_home>/jre/lib/resources.jar」を選択し、[javadoc ロケーション]ボタンを押下する。

    Javadocダイアログが表示される。デフォルトでは「Javadoc URL (例 ~)」ラジオボタンが選択され、「Javadoc ローケーション・パス」にインターネット上の日本語APIドキュメントのURLが設定されている。

    Javadoc ローケーション・パス http://java.sun.com/javase/ja/6/docs/ja/api/
  5. Javadocダイアログで、「アーカイブ内の Javadoc」ラジオボタンを選択し、「アーカイブ・パス」にローカル環境の日本語APIドキュメントのアーカイブのパス、「アーカイブファイル内のパス」に「docs/ja/api」を設定する。

    Linuxの場合

    アーカイブ・パス /opt/jdk1.6.0_27/jdk-6u21-docs-ja.zip
    アーカイブファイル内のパス docs/ja/api

    Windowsの場合

    アーカイブ・パス C:\Program Files\Java\jdk1.6.0_27\jdk-6u21-docs-ja.zip
    アーカイブファイル内のパス docs/ja/api
  6. [検証]ボタンを押下して以下の確認ダイアログが表示されることを確認する。

    Javadocの参照方法ロケーションの検証中
    [!] ロケーションは有効のようです。ファイル'package-list'および'index.html'が検出されました。

    ただし、Windowsでは以下の警告ダイアログが表示される。

    Javadocの参照方法ロケーションの検証中
    [!] Javadoc ロケーションは検証できません。

    どうやらEclipceの現バージョンではパスに空白が入っていると検証に失敗してしまうようだ。しかし、動作に問題は無いのでこのまま設定する。

  7. [OK]ボタンを押下して、Javadocダイアログをクローズする。

  8. JREの編集ダイアログで、「JREの編集JREシステム・ライブラリー」から「<パス名>/rt.jar」を選択し、[ソース添付]ボタンを押下する。

    ソース添付構成ダイアログが表示される。デフォルトでは「ローケーション・パス」に<java_home>の下のソースコードのアーカイブのパスが設定されている。

    Linuxの場合

    ローケーション・パス /opt/jdk1.6.0_27/src.zip

    Windowsの場合

    ローケーション・パス C:/Program Files/Java/jdk1.6.0_27/src.zip
  9. ソース添付構成ダイアログで、「アーカイブ・パス」にマージしたソースコードのアーカイブのパスを設定する。

    Linuxの場合

    ローケーション・パス /opt/jdk1.6.0_27/src_ja_utf8.zip

    Windowsの場合

    ローケーション・パス C:/Program Files/Java/jdk1.6.0_27/src_ja_utf8.zip
  10. [OK]ボタンを押下して、ソース添付構成ダイアログをクローズする。

  11. JREの編集ダイアログに戻るので、以下のライブラリの「Javadoc ロケーション」、及び、「ソース添付」も同様に変更する。

    rt.jar,jsse.jar,jce.jar,charsets.jar

  12. [完了]ボタンを押下して、JREの編集ダイアログをクローズする。

  13. [OK]ボタンを押下して、設定ダイアログをクローズする。

動作確認

設定が終わったら適当なソースに「String s;」と記述して、カーソルを合わせてShift+F2を押下する。内部Webブラウザーにドキュメントが表示されたら画面を右クリックしてプロパティを選択する。プロパティの「アドレス(URL)」が以下のようにローカル環境のアーカイブになっていれば、「Javadoc ロケーション」の設定は正しく行われている。

http://127.0.0.1:<ポート番号>/help/nftopic/jar:file:<java_home>/jdk-6u21-docs-ja.zip!/docs/ja/api/java/lang/String.html

また、「String s;」にマウスカーソルを合わせると表示されるホバー表示、及び、Ctrl+左クリックで表示されるソースコードのコメントが日本語化されていれば、「ソース添付」の設定は正しく行われている。

以上

2011/10/02、日本語APIドキュメントのダウンロードに追記した。

2011年9月 1日 (木)

Excel入門: CSVファイルをダブルクリックで開いたとき、数値の先頭の0が削除されないようにする。(増補版)

はじめに

ExcelではCSVファイルをダブルクリックで開いたとき、各列の表示形式が一律に標準となる。そのためデータが数字列の場合、自動的に数値に変換されて読み込まれる。通常ではこれで問題ないが、0011のように先頭に0が付いたデータの場合、先頭の0が削除されてしまう。同様に1-2-1、1/2/2ようにハイフン、または、スラッシュで区切られた数字が日付に変換される、1:2:3のようにコロンで区切られた数字が時間に変換される、全角数字が半角に変換されるなどの問題がある。

期待した結果

001,002,003           → |001     |002     |003     |
1-2-1,1/2/2,1:2:3     → |1-2-1   |1/2/2   |1:2:3   |
121,122,123  → |121  |122  |123  |

実際の結果

001,002,003           → |       1|       2|       3|
1-2-1,1/2/2,1:2:3     → |2001/2/1|2001/2/2| 1:02:03|
121,122,123  → |     121|     122|     123|

回避方法としては、先にExcelを起動して、ファイルメニューの開くから(Excel 2007以前の場合)、または、データメニューのテキストファイルから(Excel 2010の場合)ファイルを読み込み、テキストファイルウイザードで各列に表示形式を指定する方法が一般的だが、これをダブルクリックしか知らない相手に一から説明するのはなかなか面倒である。

この件については、以前某所に回避方法を書いたことがあったが、今回追加の調査を行ったので増補版としてあらためてまとめてみた。

回避方法の考察

とにかくデータを文字列として認識させれば良いということで、ダブルクォーテーションで括ってみる。→だめである。読み込み時にダブルクォーテーションが削除されてしまうので同じ結果になってしまう。

"001","002","003"           → |       1|       2|       3|
"1-2-1","1/2/2","1:2:3"     → |2001/2/1|2001/2/2| 1:02:03|
"121","122","123"  → |     121|     122|     123|

では、データの先頭に文字列をあらわすシングルクォーテーションを付けてみる。→文字列として読み込まれるが、シングルクォーテーションが表示されたままとなる。セルを一個一個確定し直せば意図した結果になるが…。

'001,'002,'003           → |'001    |'002    |'003    |
'1-2-1,'1/2/2,'1:2:3     → |'1-2-1  |'1/2/2  |'1:2:3  |
'121,'122,'123  → |'121 |'122 |'123 |

回避方法

データをダブルクォーテーションで括った上で先頭にイコールを付けて数式にしてしまう。こうすると読み込み時にダブルクォーテーションが削除されないので文字列として表示される。しかし、このCSVファイルをExcel以外のアプリケーションで読み込むと当然問題が発生する。

="001",="002",="003"           → |001     |002     |003     |
="1-2-1",="1/2/2",="1:2:3"     → |1-2-1   |1/2/2   |1:2:3   |
="121",="122",="123"  → |121  |122  |123  |

データの先頭にタブ文字を付ける(以下の<tab>は実際にはタブ文字)。こちらの方がスマートで良い。しかも、タブ文字は空白文字の一つなのでExcel以外のアプリケーションでも問題が発生しにくそうである。

<tab>001,<tab>002,<tab>003           → |001     |002     |003     |
<tab>1-2-1,<tab>1/2/2,<tab>1:2:3     → |1-2-1   |1/2/2   |1:2:3   |
<tab>121,<tab>122,<tab>123  → |121  |122  |123  |

同様にデータの末尾にタブ文字を付けても良い。むしろこちらの方が問題が発生しにくいかも。

001<tab>,002<tab>,003<tab>           → |001     |002     |003     |
1-2-1<tab>,1/2/2<tab>,1:2:3<tab>     → |1-2-1   |1/2/2   |1:2:3   |
121<tab>,122<tab>,123<tab>  → |121  |122  |123  |

Excelでのタブ文字の扱い

データにタブ文字を付ける方法でCSVファイルを読み込んだ場合、タブ文字は読み込み時に削除されたわけではなく、読み込まれたデータにしっかり付加されている。実際にセルのデータにカーソルを立て、矢印キーで移動すると横幅0の文字があることが分かる。以下のようにLEN()関数でデータの文字数を表示すると一文字分多く表示される。

A B:数式 B:表示
1 001 =LEN(A1) 4
2 1-2-1 =LEN(A2) 6
3 121 =LEN(A3) 4

しかも、このタブ文字は前後の空白文字を削除するTRIM()関数では削除できない。

A B:数式 B:表示
1 001 =LEN(TRIM(A1)) 4
2 1-2-1 =LEN(TRIM(A2)) 6
3 121 =LEN(TRIM(A3)) 4

タブ文字を削除するにはSUBSTITUTE()関数を使用する。尚、Excelではタブ文字を直接入力する方法がないので代わりにCHAR(9)を使用する。

A B:数式 B:表示
1 001 =LEN(SUBSTITUTE(A1,CHAR(9),"")) 3
2 1-2-1 =LEN(SUBSTITUTE(A1,CHAR(9),"")) 5
3 121 =LEN(SUBSTITUTE(A1,CHAR(9),"")) 3

以上

2011/09/02 記事のカテゴリーを変更した。

2011年8月28日 (日)

Windows入門: エクスプローラーの新規作成の「テキストドキュメント」を復活させる。

とりあえず覚え書き。

いつの間にかエクスプローラーの右クリックメニューにある新規作成の「テキストドキュメント」の表示が「TXT」になっていたので復旧方法をメモしておく。

レジストリエディタを起動し以下のキーを確認する。

HKEY_CLASSES_ROOT\.txt

通常なら以下のようになっているはずである。

名前 種類 データ
(既定) REG_SZ txtfile
Content Type REG_SZ text/plain
PerceivedType REG_SZ text

実際には以下のようになっていた。

名前 種類 データ
(既定) REG_SZ sigiltxt
Content Type REG_SZ text/plain
PerceivedType REG_SZ text

犯人が分かったので、通常時の状態に修正する。

というわけで、無事解決。

以上

2011/09/02 記事のカテゴリーを変更した。

2011年8月27日 (土)

Android入門: 開発マシンにToshiba Regza Tablet(AT300/24C)を接続する。

この記事では開発マシンにToshiba Regza Tablet(AT300/24C)をUSBデバッグモードで接続する方法を説明する。尚、開発マシンにAntoroidデバイスを接続する方法の詳細については、Using Hardware Devicesを参照すること。製造元のUSB Vendor IDなどの情報もここに掲載されている。

AT300/24C側の設定

AT300/24CのUSBの接続モードをデバッグモードに設定する。

  • 設定アプリケーション開発を選択し、USBデバッグのチェックをOnにする。

AT300/24Cの接続

USBドライバを準備してから、開発マシンとAT300/24CをUSBケーブルで接続する。

Linuxの場合

  1. 開発マシンで、AT300/24C用のudev rulesファイルを以下の内容で新規に作成する。

    $sudo vi /etc/udev/rules.d/51-android.rules
    # Toshiba AT300/24C
    SUBSYSTEM=="usb", ATTR{idVendor}=="0930", MODE="0666", GROUP="plugdev"
  2. 開発マシンとAT300/24CをUSBケーブルで接続する。

  3. 開発マシンで、以下のコマンドを実行し、接続したAT300/24Cが表示されることを確認する。

    $cd ~/android-sdk-linux_x86/platform-tools$./adb devices
    List of devices attached 1234567890ABCDE device ←英数字部分はAT300/24Cの固有ID。

Windowsの場合

  1. 前回の記事の「Android SDKのインストール」でGoogle USB Driver packageを選択し、以下のディレクトリにUSBドライバがインストールされていることを確認する。

    <android-sdk-home>\extras\google\usb_driver
  2. このディレクトリの下のandroid_winusb.infファイルを修正し、[Google.NTx86]、及び、[Google.NTamd64]セクションに以下のエントリを追加する。

    [Google.NTx86]
    ;Toshiba AT300/24C
    %SingleAdbInterface%        = USB_Install, USB\VID_0930&PID_7100
    %CompositeAdbInterface%     = USB_Install, USB\VID_0930&PID_7100&MI_01
    
    [Google.NTamd64]
    ;Toshiba AT300/24C
    %SingleAdbInterface%        = USB_Install, USB\VID_0930&PID_7100
    %CompositeAdbInterface%     = USB_Install, USB\VID_0930&PID_7100&MI_01
  3. 開発マシンとAT300/24CをUSBケーブルで接続する。

  4. 新しいハードウェアの検索ウィザードが表示されるので、ドライバの検索場所に上記フォルダを指定してドライバをインストールする。

  5. これにより、デバイスマネージャーに以下のドライバが登録される。

      +-Android Phone
        +-Android Composite ADB Interface
  6. Windows XPの場合、上記デバイスに加えてMTP(Media Transfer Protocol)デバイスが検出され、ドライバのインストールに失敗する事がある。ただし、上記ドライバが正常にインストールされていれば、接続自体に問題はないようだ。

      +-その他のデバイス
        +-?MTP
  7. 開発マシンで、以下のコマンドを実行し、接続したAT300/24Cが表示されることを確認する。

    >cd C:\opt\android-sdk-linux_x86\platform-tools
    >adb devices
    List of devices attached 
    1234567890ABCDE device ←英数字部分はAT300/24Cの固有ID。

以上

2011/08/27 タイトルと本文を大幅に修正した。

2011/09/02 記事のカテゴリーを変更した。

2011年8月26日 (金)

Android入門: Androidの開発環境を作成する。(Linux/Windows対応版)

はじめに

Androidアプリケーションを開発するには、オープンソースの統合開発環境であるEclipseAndroid Developersで配布されているAndroid SDK、及び、Android Development Tools (ADT) Pluginなどが必要となる。この文書では、Linux環境、及び、Windows環境にAndroidの開発環境を作成する方法について説明する。

使用環境

  • Windows 7 Professional SP1

  • Ubuntu 11.04 Desktop 日本語Remix

  • JDK 6 update 27

  • Eclipse 3.7 Indigo + Pleiades 1.3.3

JDKのインストール

Eclipse、及び、Android SDKを使用するには、JAVAの開発環境のJDKが必要となる。ここではJDKのインストール方法について説明する。

尚、7/28にJDK 7がリリースされているが、現時点では安定していないため、JDK 6の最新版を使用する。

ダウンロード

OracleのJAVAのダウンロードページより環境に応じたインストーラーをダウンロードする。また、以降ファイルをダウンロードしたディレクトリを<download_dir>とする。

Linuxの場合

  1. JAVAのダウンロードページより、[Java SE 6 Update 27]→[JDK→Dawnload]を押下する。

  2. ライセンスに同意するため、「(o)Accept License Agreement」項目をチェックする。

  3. 一覧から次のLinux x86版の自己展開インストーラーをダウンローする。

    Product / File Description Java SE Development Kit 6 Update 27 Linux x86 - Self Extracting Installer
    Download jdk-6u27-linux-i586.bin

Windowsの場合

  1. JAVAのダウンロードページより、[Java SE 6 Update 27]→[JDK]→[Dawnload]を押下する。

  2. ライセンスに同意するため、「(o)Accept License Agreement」項目をチェックする。

  3. 一覧から次のWindows x86版のインストーラーをダウンローする。

    Product / File Description Java SE Development Kit 6 Update 27 Windows x86
    Download jdk-6u27-windows-i586.exe

インストール

インストーラーを実行し、適当なディレクトリにJDKをインストールする。以降このディレクトリを<java_home>とする。

Linuxの場合

  1. インストール先はディレクトリ/optの下とする。まずカレントディレクトリをこの下の変更する。

    $ cd /opt
  2. インストール先への書き込みは管理者権限が必要なため、自己展開インストーラーをsudoで実行する。

    $ sudo sh <download_dir>/jdk-6u27-linux-i586.bin
    [sudo] password for user: ←管理者パスワードを入力する。
  3. インストールが成功すると以下のようなメッセージが表示されるので、[Enter]キーを押下してインストーラーを終了する。

    Java(TM) SE Development Kit 6 successfully installed.
    Product Registration is FREE and includes many benefits:
      (中略)
    Press Enter to continue..... ←[Enter]キーを押下する。
    
    Done.
  4. Webブラウザが起動されJDKの登録画面が表示されるが、特に登録する必要はないため、そのままブラウザを終了する。

  5. その結果、以下のディレクトリにJDKがインストールされる。

    /opt/jdk1.6.0_27

Windowsの場合

  1. エクスプローラーからJDKのインストーラーを起動する。

  2. 起動画面で[次へ]ボタンを押下して、インストール機能の選択へ進む。

  3. インストール機能の選択で、「Java DB」のインストールの選択を解除する。

  4. インストール先については全てデフォルトのまま、[次へ]ボタンを押下する。

  5. インストールが成功するとJDKが正常にインストールされたことを示す画面が表示されるので、[完了]ボタンを押下してインストーラーを終了する。

  6. Webブラウザが起動されJDKの登録画面が表示されるが、特に登録する必要はないため、そのままブラウザを終了する。

  7. その結果、以下のディレクトリにJDKがインストールされる。

    C:\Program Files\Java\jdk1.6.0_27

環境変数の設定

JAVAアプリケーションがJDKのツール、及び、ライブラリを見つけられるように、環境変数JAVA_HOME、及び、PATHを設定する。

Linuxの場合

  1. ファイル~/.profileの末尾に以下の内容を追加する。

    $ vi ~/.profile
    # Java Development Kit
    if [ -z "$JAVA_HOME" ] ; then
      JAVA_HOME="/opt/jdk1.6.0_27"; export JAVA_HOME
      PATH="$JAVA_HOME/bin:$PATH"
    fi
  2. 変更を現在の環境に適用する。

    $ source ~/.profile
  3. 以下のコマンドを実行して、環境変数が正しく設定されていることを確認する。

    $ printenv
      :
    JAVA_HOME=/opt/jdk1.6.0_27
      :
    PATH=/opt/jdk1.6.0_27:(省略)
  4. 以下のコマンドを実行して、JDKのコマンドが実行できること、及び、バージョンが正しいことを確認する。

    $ java -version
    java version "1.6.0_27"
    Java(TM) SE Runtime Environment (build 1.6.0_27-b07)
    Java HotSpot(TM) Client VM (build 20.2-b06, mixed mode, sharing)

Windowsの場合

  1. Windows 7/Vistaの場合、[コンピュータ]を右クリック→[プロパティ]→[システムの詳細設定]→[詳細設定]タブをクリック→[環境変数]ボタンを押下し、環境変数ダイアログを表示する。

  2. Windows XPの場合、[マイ コンピューター]を右クリック→[プロパティ]→[詳細設定]タブをクリック→[環境変数]ボタンを押下し、環境変数ダイアログを表示する。

  3. 「システム環境変数」項目の[新規]ボタンを押下し、新しいシステム変数ダイアログを表示する。

  4. 「変数名」と「変数値」に以下の値を入力し、[OK]ボタンを押下して環境変数ダイアログに戻る。

    変数名 JAVA_HOME
    変数値 C:\Program Files\Java\jdk1.6.0_27
  5. 環境変数ダイアログで、「システムの環境変数」一覧から環境変数Pathを選択し[編集]ボタンを押下する。

  6. システム変数の編集ダイアログがオープンされるので、環境変数Pathの値の先頭にJAVA_HOMEの実行ファイルパスを追加する。

    変数名 Path
    変数値 %JAVA_HOME%\bin;(元のPathの値)
  7. 以下のコマンドを実行して、環境変数が正しく設定されていることを確認する。

    > set
      :
    JAVA_HOME=C:\Program Files\Java\jdk1.6.0_27
      :
    PATH=C:\Program Files\Java\jdk1.6.0_27;(省略)
  8. 以下のコマンドを実行して、JDKのコマンドが実行できること、及び、バージョンが正しいことを確認する。

    > java -version
    java version "1.6.0_26"
    Java(TM) SE Runtime Environment (build 1.6.0_27-b07)
    Java HotSpot(TM) Client VM (build 20.2-b06, mixed mode, sharing)

Eclipseのインストール

Eclipseは開発対象に応じていくつかのパッケージが用意されている。Androidアプリケーションの開発ではJAVAの開発環境が必要となるため、ここではEclipseのJAVA用のパッケージをインストールする。また、Linuxの場合、日本語化プラグインのPleiadesのインストール、及び、バージョン管理ツールのSVNプラグインのインストールについても説明する。Windowsの場合、MergeDoc Projectのサイトで日本語化済みのパッケージが配布されているので、こちらをインストールする。

ダウンロード

Linuxの場合、EclipseのサイトからEclipseのJava用のパッケージをダウンロードする。また、MergeDocのサイトから日本語化プラグインPleiadesをダウンロードする。Windowsの場合、MergeDoc ProjectのサイトでEclipseの日本語化済みパッケージが配布されているので、こちらをダウンロードする。また、以降ファイルをダウンロードしたディレクトリを<download_dir>とする。

Linuxの場合

  1. Eclipseのダウンロードページより、パッケージ一覧のヘッダーにある「Eclipse Indigo (3.7) Packages for」項目のドロップダウンリストから「Linux」を選択する。

  2. 「Eclipse IDE for Java Developers」パッケージ右側の[Linux 32 Bit]を押下して、ファイルを適当なディレクトリに保存する。

    eclipse-java-indigo-linux-gtk.tar.gz
  3. MergeDoc Projectのサイトより、「Pleiades 本体ダウンロード」の[1.3.3]を押下して、ファイルを適当なディレクトリに保存する。

    pleiades_1.3.3.zip

Windowsの場合

  1. MergeDoc Prjectのサイトより、「日本語 Eclipse / Pleiades All in One 日本語ディストリビューション (zip ファイル)」の[Eclipse 3.7 Indigo Pleiades All in One]ボタンを押下する。

  2. 「Pleiades All in One 日本語ディストリビューション (zip) ダウンロード」より、パッケージ一覧の[Java/Standard All in One (JRE なし)]の[Download]ボタンを押下して、ファイルを適当なディレクトリに保存する。

    pleiades-e3.7-java_20110704.zip

インストール

ダウンロードしたEclipseのパッケージをインストール先のディレクトリに展開する。Windowsの場合、日本語化済みのパッケージにはPleiadesの他にいくつかのプラグインが最初から含まれているため、展開されるファイルがLinuxの場合よりも多くなる。

Linuxの場合

  1. インストール先はホームディレクトリの下とする。ホームディレクトリにディレクトリeclipse-3.7-javaを作成する。

    $ cd
    $ mkdir eclipse-3.7-java
  2. GNU tarを使用してパッケージを作成したディレクトリの下に展開する。

    $ cd eclipse-3.7-java
    $ tar -xzvf <download_dir>/eclipse-java-indigo-linux-gtk.tar.gz
  3. パッケージを展開すると以下のようなディレクトリ構成となる。尚、以降<user_home>はユーザーのホームディレクトリとする。

    <user_home>/eclipse-3.7-java/
      eclipse/
        .eclipseproduct
        about.html
        about_files/
        artifacts.xml
        configuration/
        dropins/
        eclipse
        eclipse.ini
        epl-v10.html
        features/
        icon.xpm
        libcairo-swt.so
        notice.html
        p2/
        plugins/
        readme/

Windowsの場合

  1. インストール先はC:ドライブのディレクトリ\optの下とする。C:ドライブのルートにディレクトリoptを作成する。

    > C:
    > cd \
    > mkdir opt
  2. 7-zipなどのファイルアーカイバを使用してパッケージをディレクトリC:\optの下に展開する。

    > cd \opt
    > "C:\Program Files\7-Zip\7z.exe" x <download_dir>\pleiades-e3.7-java_20110704.zip
  3. パッケージを展開すると以下のようなディレクトリ構成となる。

    C:\opt\pleiades-e3.7-java\
      .metadata.default\
      eclipse\
        configuration\
        dropins\
        features\
        p2\
        plugins\
        readme\
        .eclipseproduct
        artifacts.xml
        eclipse.exe
        eclipse.exe -clean.cmd
        eclipse.exe startup.cmd
        eclipse.ini
        eclipsec.exe
        jad.exe

日本語化

Linuxの場合、日本語化プラグインのPleiadesをインストールする。Windowsの場合、日本語化済みのパッケージを使用するため、この作業は必要ない。

Linuxの場合

  1. ダウンロードしたPleiadesのパッケージを適当なディレクトリに展開する。この例ではホームディレクトリの下のディレクトリfooに展開している。

    $ cd
    $ mkdir foo
    $ cd foo
    $ unzip <download_dir>/pleiades_1.3.3.zip
  2. 展開されたファイルのうちfeatures、pluginsディレクトリの中身を全て上記でインストールしたEclipseの同名のディレクトリにコピーする。

    $ mv features/* ~/eclipse-3.7-java/eclipse/features/
    $ mv plugins/* ~/eclipse-3.7-java/eclipse/plugins/
  3. Eclipseの設定ファイル(eclipse.ini)の最終行に以下の記述を追加する。

    $ cd ~/eclipse-3.7-java/eclipse
    $ vi eclipse.ini
    -javaagent:plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar
  4. 日本語化プラグインを初期化するため、-cleanオプションを付けてEclepseを起動する。

    $ ./eclipse -clean
  5. 初回起動時にワークスペースの場所を選択するダイアログが表示されるので、デフォルトのまま[OK]ボタンを押下する。

  6. Eclipseが起動されメニューなどが日本語化されていればPleiadesは正しくインストールされている。

SVNプラグインの追加

Linuxの場合、Eclipseにバージョン管理ツールのSVNプラグインを追加する。Windowsの場合、日本語化済みのパッケージにはSVNプラグインが含まれているため、この作業は必要ない。

Linuxの場合

  1. Eclipseより、ウィンドウメニュー→[設定]を選択する。

  2. 設定ダイアログがオープンされるので、[インストール/更新]→[使用可能なソフトウェア・サイト]を選択する。

  3. 使用可能なソフトウェア・サイトの一覧で、[追加]ボタンを押下する。

  4. サイトの追加ダイアログがオープンされるので、「名前」と「ロケーション」に以下の値を入力し、[OK]ボタンを押下する。

    名前 Subversive SVN Connectors
    ロケーション http://community.polarion.com/projects/subversive/download/eclipse/2.0/update-site/
  5. 設定ダイアログで、[OK]ボタンを押下する。

  6. ヘルプメニュー→[新規ソフトウェアのインストール]を選択する。

  7. インストールダイアログがオープンされるので、「作業対象」項目

    のドロップダウンリストから以下の項目を選択する。

    --全ての使用可能なサイト--
  8. 一覧が表示されたら、以下の項目のチェックボックスをOnにして、[次へ]ボタンを押下する。

    コラボレーション
      Subversive Revision Graph (オプション) (インキュベーション),0.7.9.I20110602-1700
      Subversive SVN 統合 Mylyn プロジェクト (オプション) (作業はインキュベーション),0.7.9.I20110602-1700
      Subversive SVN JDT 無視拡張 (オプション) (インキュベーション),0.7.9.I20110602-1700
      Subversive SVN チーム・プロバイダー (インキュベーション),0.7.9.I20110602-1700
    Subversive SVN コネクター
      Subversive SVN コネクター,2.2.2.I20110715-1700
      SVNKit 1.3.5 実装 (オプション),2.2.2.I20110715-1700
  9. インストールされる項目の一覧が表示されるので、[次へ]ボタンを押下する。

  10. ライセンスのレビューダイアログが表示されるので、以下の項目をチェックして、[完了]ボタンを押下する。

    (o)使用条件の上項に同意します
  11. ソフトウェアのインストールダイアログが表示され、選択したプラグインがダウンロード、及び、インストールされる。尚、インストール中に以下の警告ダイアログが表示された場合、[OK]ボタンを押下してインストールを続行する。

    セキュリティー警告
    [!] 警告:署名なしコンテンツを含むソフトウェアをインストールして
        います。このソフトウェアの真正性または妥当性を実証できません。
        インストールを続行しますか?
  12. インストールが終了し以下の選択ダイアログが表示されたら、[今はしない]ボタンを押下する。

    ソフトウェア更新
    (?) インストール変更内容を有効にするには、Eclipseを再始動する必要が
        あります。再始動せずに、変更を適用することができますが、問題が
        発生する可能性があります。
  13. ファイルメニュー→[終了]を選択しEclipseを終了する。

  14. 日本語化プラグインを初期化するため、-cleanオプションを付けてEclepseを起動する。

    $ ./eclipse -clean

Android SDKのインストール

Android SDKのインストール方法を説明する。まず環境ごとのAndroid SDKの基本パッケージをインストールする。次に基本パッケージに含まれるAndroid SDK and AVD Managerを使用して、開発するのAndroid OSのVersionに対応したSDKのパッケージをインストールする。

ダウンロード

Andoroid DevelopersのサイトダウンロードページからAndroid SDKの基本パッケージをダウンロードする。また、以降ファイルをダウンロードしたディレクトリを<download_dir>とする。

Linuxの場合

  • Android SDKのダウンロードページより、以下のパッケージをダウンロードする。

    Platform Linux (i386)
    Package android-sdk_r12-linux_x86.tgz

Windowsの場合

  • Android SDKのダウンロードページより、以下のパッケージをダウンロードする。

    Platform Windows
    Package android-sdk_r12-windows.zip

インストール

ダウンロードしたパッケージをインストール先のフォルダに展開する。以降このディレクトリを<android_sdk_home>とする。

Linuxの場合

  1. GNU tarを使用してパッケージをホームディレクトリの下に展開する。

    $ cd
    $ tar -xzvf <download_dir>/android-sdk_r12-linux_x86.tgz
  2. パッケージを展開すると以下のようなディレクトリ構成となる。尚、以降<user_home>はユーザーのホームディレクトリとする。

    <user_home>/android-sdk-linux_x86/
      SDK Readme.txt
      add-ons/
      platforms/
      tools/

Windowsの場合

  1. 7-zipなどのファイルアーカイバを使用してパッケージをディレクトリC:\optの下に展開する。

    > c:
    > cd \opt
    > "C:\Program Files\7-Zip\7z.exe" x <download_dir>/android-sdk_r12-windows.zip
  2. パッケージを展開すると以下のようなディレクトリ構成となる。

    C:\opt\android-sdk-windows\
      add-ons\
      platforms\
      tools\
      SDK Manager.exe
      SDK Readme.txt

SDKのダウンロード

Android SDK and AVD Managerを使用して、開発対象のAndroid OSのVersionに対応したSDKのパッケージをダウンロードする。尚、回線速度にも拠るがこの処理は非常に時間がかかるため、ダウンロードするのは必要なパッケージのみに絞った方が良い。この例では、Version 2.1,2.2,2.3.3,3.1のみをダウンロードしている。

Linuxの場合

  1. <android_sdk_home>/toolsの下の以下のコマンドを実行し、Android SDK and AVD Managerを起動する。

    $ cd ~/android-sdk-linux_x86/tools
    $ ./android
  2. 左のメニューで[Available Packages]を選択すると、「Packages available for download」一覧にインストール可能なパッケージの一覧が表示されるので、以下のパッケージを選択して[Install Selected]ボタンを押下する。

    Android Repository
      Android SDK platform-tools
      Documentation for Anfdroid SDK, API 13
      SDK Platform Android 3.1, API 12
      SDK Platform Android 2.3.3, API 10
      SDK Platform Android 2.2, API 8
      SDK Platform Android 2.1, API 7
      Samples for SDK API 12
      Samples for SDK API 10
      Samples for SDK API 8
      Samples for SDK API 7
    Third party Add-ons
      Google Inc.(dl-ssl.google.com)
        Google APIs by Google Inc.,Android API 12
        Google APIs by Google Inc.,Android API 10
        Google APIs by Google Inc.,Android API 8
        Google APIs by Google Inc.,Android API 7
  3. Choose Packages to Installダイアログが表示されるので、「Accept All」ラジオボタンを選択して、[Install]ボタンを押下する。

  4. Installing Archivesダイアログが表示され、選択したパッケージがダウンロード、及び、インストールされる。

  5. インストールの最後に以下の警告ダイアログが表示されるので、[Yes]ボタンを押下してインストールを続行する。

    ADB Restart
    (?) A package that depends on ADB has been updated.
        Do you want to restart ADB now
  6. インストールが終了したら[Close]ボタンを押下して、Installing Archivesダイアログを終了する。

  7. 左のメニューで[Installed packages]を選択すると、インストール済みのパッケージが表示されるので、内容を確認したらタイトルバーの(X)ボタンを押下してAndroid SDK and AVD Managerを終了する。

Windowsの場合

  1. <android_sdk_home>の下の以下のコマンドを実行し、Android SDK and AVD Managerを起動する。

    > cd C:\opt\android-sdk-windows
    > SDK Manager.exe
  2. Choose Packages to Installダイアログが表示されるので、[Cancel]ボタンを押下してAndroid SDK and AVD Managerに戻る。ここで[OK]ボタンを押下すると全パッケージのダウンロードが始まってしまうので注意する。

  3. 左のメニューで[Available Packages]を選択すると、「Packages available for download」一覧にインストール可能なパッケージの一覧が表示されるので、以下のパッケージを選択して[Install Selected]ボタンを押下する。尚、Windows環境で実機を接続する場合、USBドライバが必要なのでGoogle USB Driver packageも選択すること。

    Android Repository
      Android SDK platform-tools
      Documentation for Anfdroid SDK, API 13
      SDK Platform Android 3.1, API 12
      SDK Platform Android 2.3.3, API 10
      SDK Platform Android 2.2, API 8
      SDK Platform Android 2.1, API 7
      Samples for SDK API 12
      Samples for SDK API 10
      Samples for SDK API 8
      Samples for SDK API 7
    Third party Add-ons
      Google Inc.(dl-ssl.google.com)
        Google APIs by Google Inc.,Android API 12
        Google APIs by Google Inc.,Android API 10
        Google APIs by Google Inc.,Android API 8
        Google APIs by Google Inc.,Android API 7
        Google USB Driver package
  4. Choose Packages to Installダイアログが表示されるので、「Accept All」ラジオボタンを選択して、[Install]ボタンを押下する。

  5. Installing Archivesダイアログが表示され、選択したパッケージがダウンロード、及び、インストールされる。

  6. インストールの最後に以下の警告ダイアログが表示されるので、[Yes]ボタンを押下してインストールを続行する。

    ADB Restart
    (?) A package that depends on ADB has been updated.
        Do you want to restart ADB now
  7. インストールが終了したら[Close]ボタンを押下して、Installing Archivesダイアログを終了する。

  8. 左のメニューで「Installed packages」を選択すると、インストール済みのパッケージが表示されるので、内容を確認したらタイトルバーの[X]ボタンを押下してAndroid SDK and AVD Managerを終了する。

ADT Pluginのインストール

Android Development Tools (ADT) Pluginのインストール方法について説明する。

  1. Eclipseを起動する。

    Linuxの場合

    $ cd ~/eclipse-3.7-java/eclipse
    $ ./eclipse

    Windowsの場合

    $ c:
    $ cd \opt\eclipse-3.7-java\eclipse
    $ eclipse.exe
  2. Eclipseより、ウィンドウメニュー→[設定]を選択する。

  3. 設定ダイアログがオープンされるので、[インストール/更新]→[使用可能なソフトウェア・サイト]を選択する。

  4. 使用可能なソフトウェア・サイトの一覧で、[追加]ボタンを押下する。

  5. サイトの追加ダイアログがオープンされるので、「名前」と「ロケーション」項目に以下の値を入力し、[OK]ボタンを押下する。

    名前 ADT Plugin
    ロケーション https://dl-ssl.google.com/android/eclipse/
  6. 設定ダイアログで、[OK]ボタンを押下する。

  7. ヘルプメニュー→[新規ソフトウェアのインストール]を選択する。

  8. インストールダイアログがオープンされるので、「作業対象」のドロップダウンリストから以下の項目を選択する。

    ADT Plugin - https://dl-ssl.google.com/android/eclipse/
  9. 一覧が表示されたら、以下の項目のチェックボックスをOnにして、[次へ]ボタンを押下する。

    開発ツール
      Android DDMS
      Android 開発ツール
      Android Hierarchy Viewer
      Android Traceview
  10. インストールされる項目の一覧が表示されるので、[次へ]ボタンを押下する。

  11. ライセンスのレビューダイアログが表示されるので、以下の項目をチェックして、[完了]ボタンを押下する。

    (o)使用条件の上項に同意します
  12. ソフトウェアのインストールダイアログが表示され、選択したプラグインがダウンロード、及び、インストールされる。尚、インストール中に以下の警告ダイアログが表示された場合、[OK]ボタンを押下してインストールを続行する。

    セキュリティー警告
    [!] 警告:署名なしコンテンツを含むソフトウェアをインストールして
        います。このソフトウェアの真正性または妥当性を実証できません。
        インストールを続行しますか?
  13. インストールが終了し以下の選択ダイアログが表示されたら、[今はしない]ボタンを押下する。

    ソフトウェア更新
    (?) インストール変更内容を有効にするには、Eclipseを再始動する必要が
        あります。再始動せずに、変更を適用することができますが、問題が
        発生する可能性があります。
  14. ファイルメニュー→[終了]を選択しEclipseを終了する。

  15. 日本語化プラグインを初期化するため、-cleanオプションを付けてEclepseを起動する。

    Linuxの場合

    $ ./eclipse -clean

    Windowsの場合

    > eclipse.exe -clean.cmd
  16. Eclipseより、ウィンドウメニュー→[設定]を選択する。

  17. 設定ダイアログがオープンされるので、[Android]を選択する。

  18. 「Android 設定」の「SDKロケーション」項目に<android_sdk_home>を設定し、[OK]ボタンを押下する。

    Linuxの場合

    <user_home>/android-sdk-linux_x86

    Windowsの場合

    C:\opt\android-sdk-windows
  19. 設定ダイアログで、[OK]ボタンを押下する。

以上

2011/08/26 新規作成。
2011/08/27「開発マシンとAndroidデバイスの接続」を別記事に分割した。
2011/09/02 記事のカテゴリーを変更した。
2011/09/19 記事の誤字と間違いを修正した。

2011年8月25日 (木)

PowerShell入門: 複数ファイルの中の文字列を一括変換する。

とりあえず、覚え書き。

最近のGNU sedには-i(--in-place)オプションというのが追加されていて、オリジナルファイルに処理結果を上書きすることができる。 たとえば、ディレクトリOEBPS配下の全てのhtmlファイルについて、html要素にxml:lang="ja"属性を追加したいときは、以下のコマンドを実行すれば良い。

$ find OEBPS -name '*.html'|xargs sed -i -e's/^<html/<html xml:lang="ja"/'

前回の記事について、Windows環境でも同様の処理を行う必要があったため、最近流行(?)のPowerShellで一行コマンドを作成してみた。 上記の例の場合、以下のコマンドを実行すれば良い。(実際には一行で入力すること。)

PS> gci -r -i *.html OEBPS|
  %{(gc -en UTF8 $_)|%{$_ -replace'^<html','<html xml:lang="ja"'}|sc -en UTF8 $_}

この例では対象のファイルが全て上書きされるのが前提だが、置換対象の文字列を含むファイルのみを上書きしたい場合は、以下のようにSelect-Stringを挟めば良い。

PS> $f='^<html';gci -r -i *.html OEBPS|Select-String $f -List|
  %{(gc -en UTF8 $_.Path)|%{$_ -replace$f,'<html xml:lang="ja"'}|sc -en UTF8 $_.Path}

説明

  • gci(Get-ChildItem)で、ディレクトリ配下から指定したパターンに一致するファイルを取得する。

  • Select-Stringで、置換対象のパターンを含むファイルのみを取得する。Select-StringはMatchInfo オブジェクトを返すため、後の処理では$_.Pathでパス名を取得している。また、デフォルトでは大文字と小文字は区別されないため、区別したいときは-CaseSensitiveオプションを追加する。

  • 最初の%(ForEach-Object)ブロックにて、ファイルを一つずつ処理する。

  • gc(Get-Content)で、ファイルの中身を取得する。尚、gcを丸括弧で囲むことで、ファイルの中身を一度に読み込んでオブジェクトが生成される。これにより、scでファイルを上書きするときにファイルが使用中でエラーになるのを回避する。

  • 次の%(ForEach-Object)ブロックで、ファイルを一行ずつ処理する。

  • -replace演算子で、置換対象の文字列を置換する。尚、デフォルトでは-replaceは小文字と大文字を区別しない。区別するには-creplaceを使用する。また、区別しないことを明示するには-ireplaceを使用する。

  • ファイルの中身がUTF-8のため、gcとscに-en UTF8オプションを指定する。

以上

2011/08/26 記事のタイトル、及び、本文の説明を修正した。
2011/09/02 記事のカテゴリーを変更した。
2011/09/07 Select-Stringの記述を追加、及び、説明を修正した。
2011/09/21 記事のリンク、及び、説明を修正した。