📄 deploying.html
字号:
<html><!-- #BeginTemplate "../Templates/tmpl.dwt" --><!-- DW6 --><head><!-- #BeginEditable "doctitle" --> <title>PTypes: deploying</title><!-- #EndEditable --> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><link rel="stylesheet" href="styles.css"></head><body bgcolor="#FFFFFF" leftmargin="40" marginwidth="40"><p><a href="../index.html"><img src="title-1.7.gif" width="213" height="34" alt="C++ Portable Types Library (PTypes) Version 1.7" border="0"></a> <hr noshade><!-- #BeginEditable "body" --> <p class="hpath"><a href="index.html">Top</a>: Deploying the shared (dynamic) library</p><p><b><br>Static vs. dynamic linking</b></p><p>Starting from version 1.7 PTypes builds two separate versions of the library: static and shared (DLL on Windows), giving you a choice, and at the same time putting into a dilemma.</p><p>Both static and dynamic linking have their advantages and disadvantages. While small applications consisting of a single executable would prefer to link the library directly, more complex projects with multiple dynamic components and executables would greatly benefit from going 'totally dynamic', including generic low-level libraries, such like CRTL and PTypes. Before making a decision, consider the following:</p><p>Advantages of static linking:</p><ul><li>Faster run-time loading (in return for slower compilation).</li><li>The installation process is simpler: the end-user doesn't have to deal with package dependencies, DLL/so versioning conflicts with other applications, etc. A simple application may run even without any special installation procedures.</li><li>Windows-specific: turning a static library into a DLL on Windows is not as simple as on Unix. You should at least put special compiler directives against every public symbol in the library and thus make your header files less readable.</li><li>Unix-specific: for security reasons, Unix has strict policies with regard to finding shared libraries and managing allowed source paths. In most cases you will have to provide an automated installation procedure and require root privileges in order to place all shared libraries in the right place. Remember, Unix is a true multiuser system, and often the user that downloaded/purchased your program does not have root access on his computer, and he doesn't want to bother the system administrator either. You may, of course, override LD_LIBRARY_PATH, but then shared libraries won't be truly shared if they are installed somewhere under user's home directory.</li></ul><p>Advantages of dynamic linking:</p><ul><li>Faster compilation and better modularization in big projects with distributed development (in return for slower run-time loading).</li><li>Bug fixes and improvements in library's implementation do not affect your application and do not require you to recompile everything. What's more, adding new features without changing the existing interfaces in the dynamic library, again, won't affect the other modules.</li><li>Smaller executables; dynamic libraries may be shared not only between the components of your project, but even between applications from different vendors. (The installation package should offer all dependent libraries anyway.) Freeware libraries perfectly suit for sharing between vendors, since they usually don't put any limitation on their usage, at least when linked dynamically.</li></ul><p>In summary, dynamic linking is good (1) for big projects, or (2) if the library is widely used by many software vendors in its dynamic (shared) form.</p><p><b><br>Using and deploying Unix shared object</b></p><p>PTypes 1.7 builds a shared object named <span class="lang">libptypes.so.1</span> and also, by tradition, creates a symbolic link <span class="lang">libptypes.so</span>. Both files are placed in <span class="lang">so/</span>.</p><p>If you decided to link your program against PTypes shared object instead of the static library, all you'd have to do is to change the library path in your makefile from <span class="lang">-L../ptypes/lib</span> to <span class="lang">-L../ptypes/so</span>. When running the program, it will then require the shared library to be either in one of the default locations (usually <span class="lang">/usr/lib</span> and <span class="lang">/usr/local/lib</span>), or you will have to override the LD_LIBRARY_PATH environment variable and point to the directory where the shared object resides, e.g. <span class="lang">~/ptypes/so</span>.</p><p>Both files, <span class="lang">libptypes.so.1</span> and the symlink <span class="lang">libptypes.so</span>, should be deployed and installed along with your application, regardless of which name you are using. The version number '1' will change when PTypes adds a number of new features and becomes significantly bigger (e.g. if we add Unicode support). This will leave you the possibility to link against the smaller version <span class="lang">libptypes.so.1</span>, if you don't want to use the new one, or if you are not aware of it at all.</p><p><b><br>Using and deploying Windows DLL</b></p><p>The PTypes MSVC project is configured so that the 'release' version of <span class="lang">ptypes.dll</span> along with the import library <span class="lang">ptypes.lib</span> is copied into <span class="lang">so\</span> as the final step of the build process. <span class="lang">Ptypes.dll</span> does not contain any debugging information and is ready to be deployed. Note that the library itself is linked against the multithreaded DLL version of CRTL.</p><p>Starting from version 1.7.1 PTypes places a VERSION resource in the DLL, allowing the system or the setup program to automatically compare the existing <span class="lang">ptypes.dll</span> the user may have in the system with the one that comes with your program. This is usually done from within the installation script.</p><p><b><br>Version checking sample code</b></p><p>If, for some reason, you wish to check the version of the shared library you linked with dynamically, you may check the global variable <span class="lang">__ptypes_version</span>, which is declared in <span class="lang"><pport.h></span>. This variable holds the version number encoded as a single integer, e.g. <span class="lang">0x010705</span> designates version 1.7.5. In this form the version numbers (required and actual) can be easily compared as integers.</p><p>If you need to check the version of PTypes before loading the library (for example, during the installation on Unix), you may write a program that loads the shared object and reads the global symbol <span class="lang">__ptypes_version</span> at run-time, using the system dynamic loading interface. Note that this program itself is not using PTypes. Some Unix systems require to link the program with <span class="lang">-ldl</span>.</p><blockquote> <pre><span class="cdir">#ifdef</span> WIN32<span class="cdir"># include</span> <windows.h><span class="cdir">#else</span><br><span class="cdir"># include</span> <dlfcn.h><br><span class="cdir">#endif</span><span class="cdir">#include</span> <stdio.h>const unsigned long required = 0x010702;<br>int main(){ void* handle; unsigned long* pversion; int exitcode = 0;<span class="cdir">#ifdef</span> WIN32 const char* libname = "ptypes.dll"; handle = LoadLibrary(libname); if (handle == 0) { printf("PTypes.DLL not found\n"); return 3; } pversion = (unsigned long*)GetProcAddress(HMODULE(handle), "__ptypes_version");<span class="cdir">#else</span> const char* libname = "libptypes.so.1"; handle = dlopen(libname, RTLD_LAZY); if (handle == 0) { printf("%s\n", dlerror()); return 3; } pversion = (unsigned long*)dlsym(handle, "__ptypes_version");<span class="cdir">#endif</span> if (pversion == NULL) { printf("Couldn't determine the version number of %s\n", libname); exitcode = 1; } else { printf("Found %s, version: %ld.%ld.%ld\n", libname, (*pversion) >> 16, ((*pversion) >> 8) & 0xff, (*pversion) & 0xff); if (*pversion < required) { printf("Need version %ld.%ld.%ld or later\n", required >> 16, (required >> 8) & 0xff, required & 0xff); exitcode = 2; } }<span class="cdir">#ifdef</span> WIN32 FreeLibrary(HMODULE(handle));<span class="cdir">#else</span> dlclose(handle);<span class="cdir">#endif</span> return exitcode;}</pre></blockquote><p class="seealso">See also: <a href="compiling.html">Compiling and Porting</a></p><!-- #EndEditable --> <hr size="1"><a href="../index.html" class="ns">PTypes home</a> </body><!-- #EndTemplate --></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -